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Preface 






This publication is in a modular fonnat and 
consists of the following modules: 

• MOEULE 1: INTROEUCTION. Describes 

OLTEP functions, structure, 
and relationship to the 
system. 

• MODULE 2: OPERATING PROCEDURES, 

Contains the information 
necessary to run OLTEP, 

• NODULE 3: RETAIN/370. Explains the 

function of the RETAIN/370 
interface and provides the 
necessary operating 
procedures. This featiire of 
OLTEP is restricted to the 
IBM Customer Engineer's use 
only . 

• MODULE 4: OLTEP MESSAGES. Lists the 

OLTEP messages. Included is 
an explanation of the 
messages and the operator 
actions that apply. 

• MODULE 5: GLOSSARY. Terms used in 

this manual. 

The modular format enables you to remove 
individual modules and insert them into 
another publication. For example, yoo may 
want to remtcve Module 4; OLTEP Messages 

and put it into DOS/VS Messages , GC33~5379. 



A tab in the upper right-hand corner 
of the first page of each module identifies 
the module by number. Each module has a 
Module Outline and a Module Index. 



The total publication has a General 
Contents and a General Index . These refer 
you to the individual module niombers. 



Figure numbers throughout the 
publication are in the form: Figure 1-3, 
where 1 is the module number and 3 is the 
figure number in that module. 



The On-line Test Executive Programt is 
designed for the lEM Customer Engineer. 
However, the customer can use it to help 
isolate system failures or to periodically 
check I/O devices. 



A working knowledge of DCS system 
concepts is a prereguisite to using this 
publication. Detailed operating procedures 
and a general background for running jots 
under the disk operating system, are 
provided in the DOS/VS Operating 
Procedures, GC33-5378. Systemi Generation 
information is provided in DOS/VS System 
Generation , GC33-5377. 
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OLTEP Function 

IBM provides a set of device test programs 
that run under control of the Disk 
Operating System. These test programs and 
the online test executive program comprise 
the online test system. The On-Line Test 
Executive Program (OLTEP) is an interface 
between the system and the test programs 
and communicates with the operator during 
the running of tests (Figure 1-1), 



OLT 



RETAIN/370 



OLTEP 



Printer 



OPERATOR 



DOS 
Supervisor 



-\l\ 



Teleprocessing 




Figure 1-1. OLTEP-System. Relationship 
Some uses of DOS OLTEP are: 

• Diagnosing I/O errors. 

• Verifying I/O device repairs and 
engineering changes. 

• Checking I/O devices. 

Some features of DOS OLTEP are: 

• Multiple device testing. 

• Data security. 

• Data protection. 

• No re-IPL time required. 

• Prompting. 

• Recognize ASCII labels; restore ASCII 
labels. 

• Accessing of error recording 
information. 

• Line connection routine for remote 
terminal testing. 

• SOSP support. 

• RETAIN/370 

• Trace option — will provide a trace of 
OLTEP modules entered fran the OIT. 



Equate — Allows use of existing CDS 
for devices with the same configuration 
but different addresses. 



Systems with multiprcgraitiirdng 
capabilities have the added advantage of 
performing productive work while running 
the online tests. 



OLTEP operates much like ether problem 
programs in the disk operating system. It 
is cataloged into the cere image library 
and called by standard job control 
statemients. When OLTEP is called, it 
notifies the operator that it is active and 
it communicates with him during testing. 
OLTEP can run in a batch-only system or as 
a background program- in a multiprograming 
environment but must be executed in a real 
partition. It requires a minimum 14K of 
real storage in the BG Partition and the 
supervisor must include OLTEP support. 

You can test an I/O unit with miniirum 
interference to other prcgrairs running on 
the system. Testing an I/O device 
ordinarily does not interfere with system 
input and output. Any unit being tested 
(except for direct access devices) must not 
be assigned to the foreground partitions. 
Direct access devices, however, may be 
shared. 

An OLTEP user language defines and 
controls the test. With this language you 
select the devices to test, the test 
sections to run, and the options to 
exercise. You enter this information via 
the console device or in the form of a 
control statement in the job input stream. 
This information is referred to as the 
test-r un definitio n, which is common to 
OLTEP components for all operating systems. 



You can test multiple devices of the 
same type with no operator interventions 
other than these required for data 
protection and data security. OLTEP loads 
and ex«:utes the test sections one at a 
time until all the tests f cr cne device are 
completed. The test sections then repeat 
for the next device if one was requested 
and is available. Testing continues in 
this manner until all units in the test-run 
definition are tested. 



During testing under control of OLTEP, 
the system error recovery procedures are 
bypassed for the device being tested. 
CITEP has built-in data integrity 
safeguards sc that no data is destroyed 
(except on a EASD voluire labeled CEPACK) 
without operator permission. 
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OLTEP Structure 

The OLTEP ccitiponent requires a minimuir of 
14K in the background real partition and at 
least IBK xf KeLair. J70 is active. (See 
jyiodule 3, Figure 3-2.) Because the sum of 
the OLTEP and On~Line Test (OLT) functions 
exceed this allotted space, transient 
modules are loaded and executed as needed. 
To do this ^ the 14K partition is subdivided 
into three areas (Figure 1-2). 



One area of at least UK is reserved for 
the OLT. The remaining lOK contains the 
OLTEP resident and transient areas. The 
resident area (nucleus) consists of tables, 
pointers, and coding that must reside in 
storage during the execution cf OLTEP. The 
transient area is reserved f cr modules that 
have limited use and need net be resident. 
One or mere transient modules can be in 
main storage at a given time. These 
supporting modules, when needed, overlay 
previous 1^^ loaded modules in the transient 
area. 



Online Tests (OLTs) 

Th t_ I B t^ C u £ t ciT e r F rig i n e e r s u | p 1 i. es the OLT s 
on magnetic tape -ct cards- Yrrj iriust 
catalog the desired tesi-s „i:tc the core 
image lihrar-v nf^fr^re inev can be executed 
by OLTEP. See Generati ng ar OLTEP Library 
for tne cataloging procedures. 

CITS arc-^ callc^d into roain storage for 
execution Idv tiie rcheduler portion of the 
CLTEF nucleus. Tests Ticrmaliy do not 
exceed 4K. Hcwt:''?erj those that do exceed 
4K are loaded i i rlie allotted background 
partition is Jr?. rge encuqh- If the 
partiticFi is r.ct large cr.cagh^ an error 
message ic issued and the OLT is bypassed. 

CITEP provides a facility that allows 
the CIT to be divided irtc a icor segment 



a -sot? zdLt:^ 



: wnd^-^i^^-' ,„ A 1-^ hough the 
rerrriir in main storage 



root seqTrer.r r:u: 

for the auratxcn of a particular test, the 

supporting test modules are loaded from' the 

core image library by OLTEP as they are 

needed. 
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Figure 1-2. 



Main Storage * 

OLTEP Structure (Without 
RETAIN/ 370) 



Information about individual tests 
appears in the writeup that accompanies 
them. 



Kote 1: Device tests that are run for tape 
are for the piiysical device itself, rather 
than for any control unit to which a device 
may be attached. 

_Kote_2: Kcst CLTS are designed to test 
channel attached devices. Unless the OLT 
writeup specifies support cf native 
attachments testing shculd he limited to 
channel attached devices. OLTS run on 
natively attached devices can cause 
misleading errcr messages unless the OLT 
has been designed for such testing. 



Operator Communication 

OLTEP gives the operator roaxiirum control in 
running the tests. If you have a console 
device assigned to the system, and do not 
choose to enter the test-run definition by 
card, a commu nications interval is 
established. Once the ccmmuni cations 
interval is initiated, OLTEP issues a 
message requesting the cperatcr to enter 
the test-run definition. At this time the 
operator can enter or change the testing 
procedure, request prompting, request a 
dump, terminate OLTEP, specify equate or 
start Fetain/370 (see Module 3). The four 
methods of initiating a communications 
interval ares 
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The initial comminicaticns interval 
automatically occurs when OLTEP is 
first called in. At this time the 
initial test-run definition is 
entered. 



2. You can invoke an interrupt 

communications interval when the CIT 
is running by pressing the Interrupt 
key on the console. 



3. The first error comiruni cations 
interval occurs when an error is 
encountered during a test. The 
operator can suppress it by entering 
Nfl (No First Error) as an option in 
the test-run definiticn. 



The test completion cciriruni cations 
interval automatically occurs when the 
specified testing procedure ends. 



Data Protection 

OLTEP assumes much of the responsibility? 
for the protection of customer data. The 
data-protection modules within OLTEP 
protect customer files and storage during 
the online tests. The objectives of the 
data -protect ion modules in the order of 
their priority are to: 

1. Protect customer data. 

2. Allow effective testing within 
constraints of data protection. 

3. Minimize manual interventions. 

All requests for device testing are 
channeled through the data- protection 
modules. The following sections show the 
data-protection measures invoked for 
specific device types. 



All Devices 

OLTEP performs a device-ready check on all 
devices to satisfy the Ready requirement 
for the tests and to allcw execution of the 
data-protection checks. If the device is 
not read^, OLTEP issues a message 
containing the Channel Status Word (CSW) 
and sense information. The operator is 
then given options to control further 
testing of the device. 



Tape Devices 

OLTEP makes three checks before testing a 
tape device: 

1. Standard Label: OLTEP checks for a 
standard label to insure a test volume 
is mounted. If a standard label is 
not recognized, OLTEP checks for a 
standard label in ASCII m.cde. If a 
standard label is net recognized at 
this time, a message is issued stating 
that a nonstandard labeled tape is 
mounted. The operator then has the 
option to bypass the test, retry the 
test after mounting a different tape, 
or to proceed testing with the tape 
that is mounted. 

Kgte: If no bit pattern is read (tape 
is new or clean) , OLTEP will read to 
the end of the reel, rewind, and 
retry. To avoid this, some bit 
pattern must be written on new or 
clean tapes. 

2. Security: OLTEP checks the security 
b^fte in the VOL 1 label. If security 
protected, a message is issued stating 
the volume cannot be used as a 
scratch. The operator can bypass the 
test or retry the test after mounting 
a different tape. 

3. Expiration rate: The expiration date 
is checked to determine if it has 
expired. If it hasn't, a message is 
issued indicating that volume has 
unexpired date. Options are then 
available to bypass the test, retry 
the test after mounting another tape, 
or to proceed testing with that tape. 

When testing of a tape device is 
completed or discontinued, and a standard 
label has been successfully read before 
testing, OLTEP rewinds the tape and writes 
a standard label. The following records 
are written: 



— -,.- 



VOIl I Volume S/N | 70 bytes of zeros 

X«. L 



I HDPl I 76 bytes of zeros 

L X 



OLTEP dees not attempt to write a label 
if a standard label was not read at the 
beginning of the test. 



4 



Unit Record and TP Devices 



Note ; Eor a detailed description of the 
messages and replies, see OLTEP Messages in 
this publication. 



The device-ready check is the only 
data -protection task performed on unit 
record and TP devices. 
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Direct Access Storage Devices 

The device-ready check is the initial data 
protection task perforired en all direct 
access devices. If the device is ready, 
CLTIP determines the type cf DASD being 
tested, and perforirs the data-protection 
tasks for that device type. 

IBM DASD Other Than 2 321 



Space AUocation 

Before Write testing is perfcrired on a 
direct access vcluire ether than a CE 
volume, and the device is net shared, the 
CLTEP issues a iressage asking if voluire 
data can be destroyed. If the reply is YES 
testing proceeds in ncn-FPW. Otherwise, 
testing proceeds in FPK. 



CLTEP perforirs checks to determine if the 
volume can be tested in non file protect 
mode, file protect mode, or is not to be 
accessed at all by the OIT. 

Non-file Protect Mode results if the 
volxmie has been identified as a Customer 
Engineer (CE) volume, and is not shared 
with another partition. 

File Protect Mode (FPM) results if: (1) 
the volume has been identified as a CE 
volume and is shared, or, (2) it is not a 
CE volume, but has a standard label and is 
not security protected, cr, (3) the voliame 
does not have a standard label and the 
operator has replied 'P • for PROCEED to the 
E139D message. 

I Unaccessable (by the OLT) volume, 
identified as not a CE volume and: (1) has 
a standard label but is security protected 
or, (2) has not a standard label and 
operator responds 'B* for BYPASS to the 
E139D message. 

This presents three levels cf protection 
or testing: 



Note: If testing is in ncn-FPM, the test 
section may reformat the volume. 
Reformatted volumes are not recognized as 
usable by the operating system. 



File Protect Mode (FPM) 

File protect mode allows testing of a 
direct access device without destroying 
volume data. While in FPM, CLTEP scans the 
channel program for any Write commands that 
violate data security cr protection. OLTEP 
can perform only a limited test when 
operating in this mode. 



Non-File Protect Mode (Non-FPM) 

When operating in ncn-FPM, CLTEP allows the 
test to perform Write and Read Data 
operations on the device. Cylinders in the 
CE volume are allotted for this function. 
The same cylinders are used en both CE' 
volumes and scratch volumes. 






1. Volume Security Byte is ON — no 
testing can proceed on this pack. 

2. Non-CE PACK, Volume Security Byte is 
OFF or CE PACK is shared — Testing 
proceeds in FPM. (Testing can proceed 
in non-FPM with operator permission 
■See SPACE ALLOCATION paragraph 
below.)) . 

3. CE PACK (Non-shared) — Testing 
proceeds in non-FPM. 

Note ; System: protection of system secure 
data sets is bypassed and system secure 
data sets may be destroyed if the volume is 
not security protected. (See SPACE 
ALLOCATION paragraph belcw.) 

IBM 2321 

If the device to be tested is an IBM 2321, 
OLTEP ensures that the CE vclume is mounted 
in bin 0, then turns control ever to the 
test section. If OLTEP finds that the 
volume mounted in bin is net a CE volume, 
no testing can be performed. OLTEP then 
gives the operator the option to bypass the 
test, or to retry the test after mounting a 
CE volume. 



Accessing of Error Recording Data 

CLTEP can retrieve records f rem an 
environmental recording data set for use by 
the CIT. CLTEP has the ability to access 
any one of the following data sets:; 

1. DCS System Recorder File (SYSREC). 

2. DCS History Tape. 

3. CS History Tape. 

History tapes are created by the Error 
Recording Environm^ental Prccedures (EREP). 

Upon receiving a request from the OLT 
for this information, OLTEP asks the 
operator tc identify what media the data 
set resides en. If the operator responds 
to access the SYSREC file, CLTEP will 
perform all the necessary furctions to 
access the file. If the EREP history tape 
is to be used, CLTEP requests the operator 
to miount the tape en a free device and 
enter the device address. Yeu must assign 
this device tc the background partition, 
but do not include it in the test-run 
definition. 
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System Preparation 



The follovjing system generation macro 
parameters apply to OLTEP: 



FOPT OLTEP=YES 
FOPT OLTFP=NO 

FOPT 0C=YES 



FOPT RETAIN=YES 



FOPT RETAIN=NO 

YES 
FOPT IT= BG 



Default. 

If OLTEP support is not 
desired. 

(1) Forced when OITEP=YES 
is specified. 

(2) Allows you to force a 
c oirmuni cation s 
interval using the 
console interrupt. 

This option permits the 
use of the REmiN/370 
functicn of OLTEP. 

Default. 



Will improve the 
performance of OLTEP in a 
mu Itiprogramming 
environment. 



You must catalog OLTEP, Ccnfiguration 
Lata Sets, and Online Test Section into the 
core image library before ycu can run the 
tests. Procedures to catalcg OLTEP are in 
EOS System Generation , GC33-5008. 
Procedures for creating a link-editable 
file containing the desired Ccnfiguration 
Data Sets and Online Test Sections can te 
found in SOSPB Operator's Guide 
(D99-SOSPB-0a). 



Timer and TOD Clock 

If TOE=YES is specified in the SYSGEN, the 
timer must remain enabled during the 
running of OLTEP, and the TOD clock roust be 
set and operational. If Timer or TOD clock 
becomes non-operational, OLTEP may enter an 
enabled WAIT state or hang in a loop 
waiting for the Timer or TOD clock to step. 
If this condition occurs, cancel the CITEP 
JOB and insure that the Timer and TOD clock 
are operaticnal before attempting to 
restart OLTEP. 



Generating the OLT/CDS Library 

The Customer Engineer must crder a 
diagnostic tape from PID. The tape 
contains : 

• The OLTs. 

e OLTSIP, a stand alone version of CITEP. 

• The Stand-Alone Service Program (SCSP) 
that is used to create a jcb stream to 



catalog the OLTs and CESs into the core 
image library. 

Note: SOSP can alsc be executed as 
though it were an OLT under OLTEP. If 
SCSP is required tc be run, the CE 
should be consulted. SOSP Release 4.1 
or higher is required. 

This material can be obtained on a disk 
pack if there are no tape devices on the 
system. 

The EDITDCS program cf the Stand-Alcne 
Service Program is used tc create OLT and 
CDS input for the EOS Linkage Editor. This 
input can be created on disk cr tape. 

The job control statements required to 
link the ClTs and CESs into the core image 
library are as follows: 

(1) Tape Input 

// JCB XXXXXXXX 

assign work files for Linkage 

Editor if necessary 

// assgn SYSIN,X'CUU' 

where CUU is tape address 

ECE 



(2) Disk Input 

// JOB XXXXXXXX 

assign work files for Linkage 

Editor if necessary 

// DLBL IJSYSIN,"EEITPACK' / 

assgn SYSIN,'CUU" 

where CUU is disk address "^ 

ECE 

The OLTs and CESs are required to run 
tests under CLTEP. The CE will create the 
library using the specified procedure. 
This procedure is also used tc add new OLTs 
and/or CDSs when devices are added to the 
system. 



Unreferenced Symbols 

A DCS link edit of the OLT Library may 
produce unreferenced symbcls. These 
symbols are used tc ccntrcl the OLT Library 
and should be ignored. 



Device Preparation 

Certain device setup procedures are 
necessary before testing tc insure 
protection and security cf customer data. 
The following sections shew the 
requirements for individual device types. 



AH Devices 

All devices should be in the Ready status 
with no manual intervention required. 
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Tape Devices 



El 02 I CLTS RUNNING 






Moxmt a standard labeled scratch tape, 
either EECDIC or ASCII. If ycu do not 
moxmt a standard label tape, ycu are given 
options to bypass the test, iroiint another 
tape and try again, cr tc proceed testing 
with the tape that is irounted. 

Note : If OLTEP recognizes a standard label 
at the start of the test, it writes one at 
test completion. 



Direct Devices: IBM DASD Other than 2321 

If a Custoitier Engineer Vcluire is not 
available, you should irount a volume with 
serial number CEPACK on the device to be 
tested. Testing is restricted to File 
Protect Mode unless you reply R 04, 'YES* to 
the 04E120D message (CAN VOL DATA ON XXX BE 
EESTROYEE? Reply YES or NO) , and the 
device is not shared. Testing then 
proceeds in non-file protect mode. 

Note : Eile protect mode allcws only 
limited testing. No ^rite operations are 
performed. Some sections require a 
Customer Engineer Volume. See OLT 

documentation for this requirement. 



Direct Access Devices: IBM 2321 

You must mount a CE cell in bin 0, subcell 
19. If ;^ou do not mount the cell, the 
device cannot be tested. 



Terminal Devices' Local 3270 



E13iH WARNING-DASD 
VOLUME LABELED CEPACK 
NOT PRCTECTED FROM WRITE. 

E107I CPTICNS ARE (list cf default 
options) 

01E105D ENTER DEV/TEST/OPT 

You can now enter the device Cs) to test, 
the test(s) tc run, and the cption(s> to 
apply. This is the test-run definition . 
The selected test is then read from the 
core image library and executed. 

Other ways that you can initiate a 
communications interval are: 

• Tfce first error communications interval 
occurs if an error is detected while 
testing. Ycu can suppress it by 
entering NEE as an opticn in the 
test-run definiticn. 

Note: First error option is ignored if 
the no print (NPR) option and either 
tfce error loop (EI) cr test loop (TL) 
option is specified. 

• You can initiate an interrupt 
communicati cns interval by pressing the 
Interrupt key en the console when the 
CLT is running. 

• ^ test completion communications 
interval occurs automatically when the 
specified testing procedure ends. 

At communicaticns intervals, ycu can 
initiate tliese actions: 



1 



A special ETAM facility allcws OLTEP to 
test devices of a locally attached 3270 
display system without requiring the BTAK 
application program controlling it to 
terminate. This facility requires a 
procedure from the system ccnscle prior to 
beginning OLTEP. This procedure is 
described under the Local 3270 Display 
System description in the section 'LCCAI 
DEVICE-DEPENDENT CONSIDERATIONS' in BASIC 
TELEC0MMX3NICATIQNS ACCESS METHOD GC30-5001, 



System Operailoii Witii Console Input 

Diaring initiation, OLTEP determines if card 
input is selected. If it has not been 
selected, all communication with the CE is 
through SYSLOG (see section "System 
Operation ^ith No Console" if SYSLOG is not 
assigned to console) . If card input was 
not specified, the initial ccmmimications 
interval is invoked, and the following 
messages are issued: 



• All intervals — 

Run another test. Any cr all test 
entries can be changed. If a field is 
omitted, the entry specified in the 
previous test-run definiticn is used. 

Dump tte real background partition by 

entering K 01,* DUMP'. 

Request prompting. See Prompting . 

Terminate OLTEP by entering 
R 01, 'CANCEL'. 

Request Equate CDS facility by entering 
R01,'EQU' (See Device Equates). 

Initiate Retain/ 370 by entering 
R 01,'REI'. (See module 3.) 

Cancel Retain/370 by entering 
R 01,'STOPREI'. (see module 3.) 

• Test Completion — 

Repeat the test by entering R 01, '///' . 
(Not valid at initial ccmmunicaticn 
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interval,) The device, test, and 
option fields specified in the previous 
test-run definition are used. 

• First error or external interrupt — 
Continue test at point of interruption 
by entering R 01, •///•, cr 
ROl, '//option change/'. 

Initiate dynamic CE coiriruni cations by 
entering R 01, 'TALK'. 

All messages to and from the console 
device are printed on the SYSLST device. 



System Operation With Card Input 

When card input is selected, communication 
intervals other than first error or 



interrupt will read frcir SYSIPT. The first 
error and interrupt coirirani cation intervals 
remain the same and will apear on SYSLOG. 
If the last card is not CANCEL a 
communication interval will be given on the 
console. The allowable replies are the 
same as specified in the previous section. 



System Operation With No Console 

If SYSIOG is net assigned to a console, 
input is automatically taken from SYSIPT. 
Ko request will be presented en SYSLOG and 
CLTEF will terminate when all cards have 
been read . If operator ccmmuni cation is 
required by the CLT or by CLTEP, the OLT 
will be bypassed cr CLTEP will be canceled. 



f 



Calling OLTEP 
Ail Systems 



Figure 2-1 shows the job ccntrcl statements necessary for the executicr 
of OLTEP. 



^- 



STi^TEMENT 
// JOB XXXX 



"T 

I 

I i^andatory, 



Comments 



// ASSGN SYSnnn,X*cuu' j One ASSGK statement is nece 

I accessed by a test. IS^one i 
I fexmanently assigned. 



ssary for each device tested or 
s required if the device was 



h 



„^ 



// UPSI 01 



j This statement is necessary 
I but the test-run definition 
I job stream. 



if a cotiscle device is available 
is tc be entered via the input 



// EXEC UZADOLT, 

REAL, [SIZE=NK] 



j f^andatory, CITEF will run c 
I Size ~ parameter must be mi 
I invoked. This will allow a 
I larger than 4E are to be ru 

I Sfecity a size equal to lOK 
j size specified m.iDSt he jriilt 



nly in real. 

nimuir cf 14K cr 18K if RETAIN is 

4K CLT tc execute. if ui^ls 
rj , th e SIZE ~ para n et ex must 

flus the size cf the OLT. The 
ifle Cf 2K. 



i 



dev/test/opt/ 



j This statement is included 
I entered ^ia the input job s 



if the test-run definiticns are 
tream- 



/* 



j Kandatory. 



/S 



I Kandatory. 

-L , 



Figure 2-1. Job Control Statements 



The format of the ASSGN statement is: 

// ASSGN SYSnnn,X'cuu' 
SYSnnn = symbolic unit name (SYS000-SYS221) 



c = channel number 

uu = unit address 

Fote: If SYSLCG is not a ccrscle^ card 
input must be used. 
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RuBiiing the Tests 



Example 



) 






> 



The repl^r tc the ' 01E105D ENTER 
EEV/TEST/OPl/' message, the test - run 

uef initicii , consists of tnree fields: 

1. Eevice Address Field (DEV) - This 
field contains the physical address or 
syiTibolic name of the device (s) to te 
tested. Synibolic names are supported 
for the purpose of designating a 
remote TP unit as the test device. 

2. Test Field (TEST). This field 
contains the name of the tests to be 
run and may be divided into three 
subfields: test type, section, and 
routine. 

3. Option tield (OPT). This field 
specifies options affecting both the 
test itself and the printed output of 
the test. 

Each cf the three fields is follov.ed ty 
a slash- The initial test-run definition, 
whether entered on card cr via the console, 
must include information in the device and 
test fields. If you dc net specify 
options, default options are supplied by 
CLTEP. 

The correct reply fcrirat is: 

R 01, 'dev/test/cpt/' 
EEV/TESl/OFO:/ (for card input) 

An exam.ple of a reply shewing physical 
device addresses is: 

R 01, • 0181-0183/2400A/NFE,TL(10)/' 

In this example, devices 181, 182, and 
183 are tested by test section T2a00A. The 
first error communications option is 
suppressed, and the Test Lccp (TL) option 
is selected. The test runs 10 times. 

Note : A symtbolic name (for example, NYC 01) 
can be used in a test definition to enter a 
remote TP device, ^hen a grcup of devices 
is to be entered symbolically, each must be 
indicated as a separate entry (for example, 
NYCOl, NYC02, NYC03) . 

At subsequent comimunicaticns intervals, 
you can omit any or all cf the fields. If 
you omit a field, the entry in the last 
test-run definition in which the field Vras 
present is used. If you omit both the 
device and test fields, the same test(s) 
are performed on the same device (s). 
However, if they are both omitted at a 
first error communications interval or 
interrupt communications interval , the test 
is reentered at the point where the error 
or interrupt occurred. 

In all cases, three slashes must always 
be entered. 



Previous test-run-def initicn entry 
R 01,»0181/2400A/TL(5)/* 

Current test-run-definiticn entry 
R 01,V2a00C-E//* 

In this example, we use the device 
selection and test option specified in the 
previous test run. However, routines C 
through E cf the T2U00 test are run this 
time instead cf section A. 



Choosing the Devices 

The device address field contains either 
the physical address or symbolic name (for 
remote TP devices) of the device to be 
tested. The two types cf addresses that 
can be contained in the device address 
field are defined as fellows : 

1. Physical addresses ~ contains either 
three or four digits. For exam.ple, 
you can enter device 181 as 181 cr 
0181. You must separate multiple 
entries in this field with commas and 
you can use the hyphen to indicate 
inclusive devices. 

2. Symbolic names — contain from one to 
eight characters and must begin with a 
character A thru Z,$,#, era. 

(Example: NYCOl). A symbolic name 
may be one to eight characters Icng. 
Symbolic naming cf a multiple or group 
entry can be done crly ty including 
each separate entry cf the multiple or 
group separated by a ccmma. 

The symbolic or physical device field 
can accommodate up to 16 devices and is 
terminated by a slash. Figure 2-2 shows 
examples cf device selection. 



Rest rictions; If an input device is 
required by the test section fcr Eat a Input 
Support or retrieval of environmental 
recording information, you must not enter 
that device in the device- address field. 

You roust not enter physical addresses 
and symbolic names in the sane device field 
entry. You must also ret enter the same 
physical address or the same symbolic name 
more than once per entry. 

If POWER is active, the device entry 
should not include any unit record devices 
assigned tc SYSIPT, SYSRER, SYSPCE, or 
SYSLST. Testing of these devices will te 
bypassed if they are specified. 
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r - — - ^ « 

EEV Entry | DEVICE (s) Selected 

L« _ I 


0185/ |185 
4 

NY GOV [(Defined in symbolic 

JCDS) 
|. 4 ^ 

10185-0187/ 1185,186, and 187 
L - _l 


|NYC01,NYC02,NyC03/| (Defined in symbolic 
1 |CDS) 

^ 4 

0185,0187-0189/ | 185, 187, 188, and 189 
_ 1 


0181,0282,0283/ | 181, 282, and 283 
4 

/ |t3se device (s) assigned 
jin previcus test. 
1 (Note) 

.NDR JNo device required. 

1 (This irust be a single 
1 entry. ) 

Note: The device address irust be 
reentered if the device was bypassed in 
the previous run, or was invalid in the 
initial entry. 



Figure 2-2. Exainple of Device Selection 



Choosing the Test 

The test field specifies the test(s) to 
run on the selected device (s). The field 
is terminated by a slash (/), and is 
composed of the following subfields. 
Figure 2-3 shows examples. 

• Test Type (required) . Specifies the 
type of I/O device tc test. You can 
specify only one test type in a single 
test-run definition. If ycu want to 
run a test more than once, use the 
Test Loop (TL) option. 

The test type includes the prefix: 



If the prefix is ciritted, I is 
assumed. Nc ether prefix entry is 
valid. 



• Section (cptional) . Individual 

sections cf the test are indicated by 
an alphabetic character (s) within the 
range A-ZZZ. The maximum number cf 
sections that can be run during any 
one test-run definition is 26. Ycu 
must separate test section entries 
with a comma or hyphen (indicating 
inclusive sections). Multiple section 
entries are run in the sequence 
entered, duplicate entries cause a 
secticn tc be repeated. If you 
specify a test secticn that cannot be 
found, an error message is issued, and 
testing continues with the next test 
secticn if cne was requested. Consult 
the CIT writeup tc deteririne what test 
sections are available. 



If you omit the test secticn 
identification secticns h through Z 
are attempted. If the test does not 
have secticns A through Z, an error 
message is issued for each section 
that is missing. These test sections 
that are present run normally. 



Poutine (cptional) • OLTEP permits 
routine selection only when you 
specify a single test section. There 
is a maximum, of 255 routine selections 
allowed, and they are specified by 
number. Ycu can enter them in any 
sequence, but they will run in numeric 
order. Ycu must separate these 
entries with a conma cr hyphen. The 
routine numbers are found in the 
writeup that acconpanies the OLT. 



i 



V. 



N 



IBM Printer tests. 



R - IBM 2540 Reader tests. 
P - IBM 2540 Punch tests. 
T - 7^11 other tests. 



i 
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TEST ENTRY 

■T2311/ 

SOSPB/ 



I TEST(S) SELECTED 



— 4- 



Run all T2311 tests vfithin the range i^.-Z, (Ncte 1) 



I Selects Stand-Alone Online Test Support Processor Program 



T2311A,C/ 1 Run 


sections A and C of test T2311. 




T2311A-C,E,G/ 1 Run 
4 


sections A,B,C,E, and G of test T2311, 




T2311A,a/ 1 Run 


routine 4 of section A, test T2311, (Note 2) 




T2311A,4-7,2/ Run 

A 


routines 2,4,5,6, and 7 of section A, test T2311. 


(Note 2) 



P2540A,C/ 
/ 



I Run sections A and C of test P2540. 

-4- 



Use the same test(s) as specified in the previous test. (Cannot use 
initially). 



Note 1 : OLTEP atteirpts sections A through Z. A message is issued for each section 

that does not exist. Those \vhich do exist are executed. 
Note 2 : If a routine (s) is specified, only one section can be specified in that entry. 



Figure 2-3. Examples of Test Selection 
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Choosing the Optioiis 

The option field identifies the options to 
use diiring the test run. Entries in this 
field are separated by ccitroas. You can 
enter the options, with the exception of 
EXT=, in any order. The EXT=cption, vjhen 
used, must be the last entry. A default 
option is used in place of any omitted 
entry in the initial test-run definition. 
On succeeding test runs, oiritted entries 
use the options selected in the previous 



run. Figure 2-4 shows the available 
options with their default values. 



Example of OLTEP Operation 

Figure 2-5 illustrates OLTEP operation in 
the background partition of a irultiprcgram 
environirent. H console device is 
available, and console interrupts are 
permitted. The operator responses are 
underlined . 



t 



OPTION 



ENTRY 



DESCRIPTION 



OPTION 



ENTRY 



DESCRIPTION 



Testing Loop 



TL(n) 
NTL 



Recycle the test. If you specify a value (n), OLTEP 
runs the test the number of times indicated. If you 
do not specify a value, the test cycles 10 times. 
The maximum Value allowed is 32,767 decimal. 
(See Note 1 ,) 



Ert^or Loop 



EL(n) 
EL(I) 
NEL 



Authorises any error loop coded in the OLT to be 
executed the specified number of times. If you 
specify a value (n), the test loops the number of 
times indicated. If you do not specify a value, 
the test loops the number of times indicated in the 
preface of the OLT, If you specify the character 
I , a flag is set which indicates to the OLT, that 
it must loop indefinitely on the error. You can 
terminate the loop by specifying NEL following a 
request for communications, (See Note 1,) 



Print 



NPR 



Print messages from the OLT* If you enter NPR, 
dll messages originated by the OLT and normally 
designated for SYSLST are suppressed, 
(See Ndte 2.) 



Error Print 



NEP 



Print diagnostic error messages from the OLT, The 
FE option overrides NEP when a first errcr is 
encountered (once per section), (See Note 3.) 



Control 
Print 



NCP 



Print OLT start and termination messages on 
SYSLStand SYS LOG. 



Parallel 
Print 



PP(n) 
NPP 



Use the console device, in addition to SYSLST for 
OLT messages. Four levels of print are available 
on the parallel printer by entering one of these 
numbers at (n). 

HEADER only. 

1 HEADER, DESCRIPTION, tind COMMENTS, 
J_ HEADER and RESULTS. 

3 HEADER, DESCRIPTION, COMMENTS, 
and RESULTS. 



First Error 
Communi- 
cations 



FE_ 
NFE 



Manual 
Intervention 



Ml 
NMI 



Remote 



RE 

NRE 



Trace 



TR 
NTR 



EXT= 



EXT= 



Forces a communications interval when the first 
error is encountered (see Note 3). A message is 
printed indicating the test being run and the device 
being tested. This is followed by the 01E105D 
message that allows you to: 

• Change the device and/or test fields. 

• Continue the test by entering 
ROl,'///' or R 01, '//(Option change)/'. 

• Enter any OLTEP verb. 

• Cancel OLTEP by entering 
R 01, 'CANCEL'. 

There cannot be a first error communication if a 
console device isn't available. 



Informs the OLT section to run all manual 
intervention routines within the test request, 
(Manual Intervention and RE are mutually exclusive 
options,) 



RETAIN/370 only. If RE is specified, OLTEP is 
controlled by the remote specialist, who enters NRE 
to return control to the on-site customer engineer. 






Trace all functions called by OLT, (See Note 4,) 



Information following this option is passed to the 
OLT section by way of a 56 -byte buffer. This 
information must be the last entry in the option 
field, and can contain any character but a slash. 

EXAMPLE: 

ROl, '181/2 400C/TL,EXT=BLOCK4FFPRINT/' 

BLOCK 4FFPRI NT goes into a buffer area within 
OLiEF, and then passes on to the OLT section. 



The default options are underlined. 

Note 1: The FE option overrides the TL and EL options, unless NPR is also In effect. However if you enter R 01,'///' or R 01 , '//(option change)/' 
at a first error communications interval, the TL and EL options. If specified, are in effect. 

Note 2: NPR without EL and/or TL is Ignored. 

Note 3: Error print and FE are Ignored If no print and either EL or TL are specified. 

Note 4: R6utIne-to routine linkage Is not traced. Do not attempt to use Trace function when SYSLST is assigned to the test device.. 



Figure 2-4. Table of Options 



:( 
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BG 

BG 
BG 


assgn sysOOl , x ' 181 ' 

assqn sys002,x'182' ^____ — 

-4 

//iixec 1^ 7'Vk)l 1- , real , 1 SI zc = NK] (Minimum 14K) 










OLTEP is loaded Into the 
background partition. 










BG 


E102I OLTS RUNNING 




BG 
BG 
BG 
BG 


E134I WARNING - DASD VOLUME LABELED CEPACK NOT PROTECTED 
E107I OPTIONS ARE NTL,NEL,NPP , FE ,NMI ,EP ,CP ,PR,NRE ,NTR 

01E105D ENTER — DEV/TEST/OPT -<-- ""^ 

r 01, '181/2400a//' 


FROM WRITE 






Initial communications 
interval . 












CLTEP finds a nonstandard 
labeled tape mounted on 




BG 
BG 
BG 
BG 


E119I NON-STANDARD TAPE LABEL 0181-4 ' " 

04E139D REPLY B TO BYPASS, R TO RETRY, P TO PROCEED (MAY 

r U 4 , ' p ' 

E158I S T2400A $ UNIT 0181 ^ -^"''^^''^ 




the test device. 




DESTROY DATA) 




^ 


Eiror encountered. 










BG 


E129I FIRST ERROR COMMUNICATION T2400A 001 UNIT 0181 




BG 


E107I OPTIONS ARE NTL,NEL ,NPP ,FE ,NMI ,EP , CP ,PR,NRE ,NTR 




BG 


01E105D ENTER — DEV/TEST/0PT/-4 ————___ 




First error communications 




BG 


r 01, '182//nfe,tl(2)/' 




interval. 




BG 

BG 


E158I *T T2400A $ UNIT 0181 
E158I S T2400A $ UNIT 0182 










Console interrupt key 




BG 


E158I T T2400A $ UNIT 0182 ^^^^^^^^"^^^^^^ 
E158I S T2400A $ UNIT 0182 ^,^^--^''''^'^^^^^ 


"^ 


pressed. 




BG 




BG 


E107I OPTIONS ARE TL,NEL ,NPP ,NFE ,NMI ,EP , CP ,PR,NRE ,NTR 




BG 
BG 


01E105D ENTER — DEV/TEST/OPT/ 

R 01, V2400c,e/ntl/' ~^~~ ~^ ^ ~— -—__ 










interrupt communications 




BG 
BG 


E158I *T T2400A $ UNIT 0182 
E158I S T2400C $ UNIT 0182 




interval. 










BG 


E158I T T2400C $ UNIT 0182 




BG 


E158I S T2400E $ UNIT 0182 




BG 


E158I T T2400E $ UNIT 0182 




BG 


E107I OPTIONS ARE NTL ,NEL ,NPP , FE ,NMI ,EP , CP ,PR,NRE ,NTR 




BG 
BG 
BG 


G1E10 5D ENTER — DEV/TEST/OPTA<____________^ 

r CI , ' cancel ' 

IIOOA READY FOR COMMUNICATIONS 


— 






Test completion 
communications interval. 









w 



Figure 2- 5, Example of OLTEP Operation 
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Promptiiig 

If you make a syntactical errcr when 
entering the test-run definition, one df 
the following messages is issued: 

E106I INPUT DATA DOES NOT CONTAIN 3 
SLASHES 



or 



or 



or 



or 



or 



E251I DUPLICATE ENTRIES IN DEVICE FIELD 

E252I SYMBOLIC NAMES AND UNIT ADDRESSES 
MIXED IN DEVICE FIELD 

E108I INVALID ENTRY It^ DEV PLD— XXXXXXXX 

E112I INVALID ENTRY IN TEST 
ELD— XXXXXXXX 

E115I INVALID ENTRY IN OPT t'LD—XXX 



The XXXXXXXX in messages E10 8I and E112I 
indicate the portion of the entry that 
contains the error and can be up to eight 
characters in length. The XXX in message 
E115I is the entry in error and can be from 
1 to 10 characters in length. 

OLTEP then issues the next three messages: 

E161I FOR HELP, ENTER PROMl>T XXXX TO 

SUBSl^UENT DEV/TEST/OPT/ MESSAGE 

E107I OPTIONS ARE XXX, XXX, ETC. 

OlilOSD ENTER DEV/TEST/OPT/ 

At this time you can reenter the test-run 
definition, or request prompting by 
entering one of the fo Hewing: 

R 01^ 'PROMPT DEV - Examples of the 

device field. 
R 01, 'PROMPT TEST* - Examples of the 

test field. 
R 01, 'PROMPT OPT' - Examples of the 

cpticn field. 
R 01, 'PROMPT ALL* - Examples of all 

three fields. 
R 01. 'PROMPT' - Examples of all 

three fields. 

If you enter R 01, 'PROMPT DEV, the 
following examples print on the console: 

E147I EXAMPLES OF DEVICE FIELD 



0181/ 


TEST DEVICE 181 


0185-0187/ 


TEST DEVICES 185, 




186, AND 187 


CHICAGO 1 


TEST SYMBOLICALLY 




NAMED DEVICE, 




CHICAGOl 


285-286, 


TEST DEVICES 285, 


184 


286, AND 184 


.NCR/ 


NO DEVICE REQUIRED 




FOR TEST 



/ (SLASH 
ALONE) 
E107I 



01E105D 



TEST PREVIOUSLY 
SELECTEE DEVICES 
OPTIONS ARE XXX, 
XXX, ETC. 



ENTER DEV/TEST/OPT/ 



\ 



You can now reenter the test-run 
definition. 

You can invcke prompting at any time the 
•01E105D ENTER EEV/TEST/CPT/' message is 
issued. 



Device Equates 

when it is necessary tc test a device for 
which there is no CDS, the equate function 
may be used if there is a CDS for another 
device address which has an identical 
conf iguraticn (i.e., the cnly difference is 
the device address). This function is 
designed f cr the situation where a block of 
devices is en a switched channel- The 
equate function allows cnly cne CDS tc be 
generated for each device rather than a CDS 
for each possible device address. 

TO invoke the Equate function, respond 
with R 01,'OlEgU' to message E1050. If a 
test section is active, the section will be 
abnormally terminated. In any case the 
message 04E394D is issued tc ask for 
equates. Kcre than one equate can be 
entered per line, but they must be 
separated by a slash. The equates may be 
entered in three different fcrmats. In 
each format, the device address may be 
specified as three or fcur digits. 
Examples of the fcrmats are: 

(1) 280=180 

The CDS for 180 will be used 
whenever 280 is specified as the 
test device. 

(2) 272- 182- a90=191 

The CDS fcr 191 will be used for 
devices 272, 182, and 490. 

(3) 190-195=290 

The CDS for 290 will be used fcr 
devices 190, 191, 192, 193, 194, 
and 195. 

A maximum, cf sixteen equates may be 
active at cne time. Tc delete an entry 
from the table, equate the device to he 
deleted tc itself (i.e., 180=180). Tc 
clear all entries, enter ' CLR' in response 
to message 04E394D. An example of the 
response tc the 04E394E message would be: 

R 04, •CLR/280=290/191- 194=370/272, 275=390' 
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This \uoiild clear the present equates, then 
equate the devices that are specified. 
Message 04E394D will then be issued again, 
allowing more equates to be entered. When 
no more equates are to be entered, the verb 
•END" must be entered. "END" may be 
entered by itself or on the same line as an 
equate (i.e., 180=208/END) . END causes the 
active equates to be printed en the console 
for operator verification. Equates remain 
active until "CLR' is entered or they are 
individually deleted (i.e., equated to 
themselves) or OLTEP is canceled. 



After 'EQU' has been invoked, a device 
entry is mandatory to the next 01E105D 
message. 



Special Operating Considerations 

When running printer tests, assign SYSIST 
IGN or assign SYSLST to ether than the test 
device. See also Running OLTEP With Power 
in this section. 



Some OLTs require special operating 
considerations. These tests are identified 
by a dollar sign ($) after the section 
field of the start and terminate messages. 



• The following messages cannot occur: 

04E120D 

E198I 

ElOOI 



Quiesce Mode 

Some functions requested by the OLT require 
that all jcbs in the foreground partition 
be temporarily stopped. If TP is not 
active on the system, OLTEP issues a 
message asking if the foreground partitions 
can be quiesced. If you reply R 04, 'NO', 
CLTEP informs the test section that the 
requested function is net available. If 
you reply R 04, 'YES', CLTEP issues a 
message requesting that the foreground jobs 
be stopped. You must new give the operator 
commands to stop all jcbs in the foreground 
partitions. CLTEP returns control to the 
test section after it ensures the 
foreground partitions are quiesced. If you 
reply R 04, 'YES', but do net quiesce the 
foreground partitions, OLTEP cannot 
continue. If TP is active en the systemi, 
the test section is informed that the 
requested function is net available. 

You can find the procedure to quiesce 
the system in the writeup for message 
E222I. 



Line Connection Routine 



I 



examples S T2400A $ UNIT 0182 DDDDDDDD 
T T2400i^ $ UNIT 0182 DDDDDDDD 

The following apply only to these tests: 

» A first error communications interval 
cannot occur if either the Error loop 
(EL) or No Error Print (NEP> options 
are specified. 

• You may not specify a value with the EL 
option. If you enter the EL option and 
an error occurs, the test loops on the 
error indefinitely. There are two ways 
to terminate the error Iccp: 

1. Force a communicaticns interval 
\vith the External Interrupt key. 
This is effective cnly if 
interrupts are permitted, and the 
error loop is large enough to sense 
for them. 

2. Cancel the background partition 
using the system commands. 

» Direct access volumes cannot be 
reformiatted if the test vcliame does not 
have a volume serial number of CEPACK. 
In this case, testing is restricted to 
file protect mode. 



In order tc execute on line tests for 
remote teleprocessing devices, OLTEP 
provides the capability fcr establishing a 
line cennecticn between the Transmission 
Control Unit (TCU) and the remote terminal 
xmder test by means of a Line Cennecticn 
Routine. CLTEP determines the sequence of 
I/C commands (channel Program) needed to 
establish a line cennecticn from 
informaticn contained in the Configuration 
Data Set fcr the remote terminal under 
test. 

In some instances, in order tc obtain a 
line connection, you may be required to 
complete the line cennecticn of a 
teleprocessing device by dialing. The 
proeedure to be followed is found in the 
wxiteup for messages E405I and E406I. 



Reply Codes 

All DCS CLTEP two-way messages require 
response with the appropriate routing code. 
Failure to insert the proper routing code 

will result in message E175I being printed, 
A t^o-%iay message requiring a reply can be 

identified by the m-essage nuiit-sr tcllcwed 
by the letter * E* « Wner: ;:liis occurs^ the 
opera tor/CE should reply with 2 
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R XX, 'reply text' 

Where, the XX is the routing code. The 
appropriate routing code for a tvo~\**ay 
message iiwriediately precedes the message 
ID. 

Example A: 

For 01E10 5B ENTER DEV/TEST/OPT, the 
routing code is 01. 

Example B: 

For 04E199D INCORRECT REPL^, the routing 
code is 04. 

Note: When in a two-way message the 
operator is asked to reply with EOB (end of 
block), the reply should be R XX,''. The 
quotes C) with no intervening text or 
blanks signifies end of blcck to OLTEP. 



Running OLTEP With Power 

The following procedures are 
recommendations for running OLTEP with 
POWER: 

1. To test devices running OLTEP under 
POWER with the exception of SYSIST, 
SYSPCB, SYSRDR or SYSIN devices. 

In order to see diagnostic messages 
immediately use the PP(3> option in 
the option field of the DEV/TEST/CPT/ 
statement. This option causes all 
messages to the printer to also be 
printed on the console. 

2. To test SYSLST, SYSPCH, SYSRDR or 
SYSIN devices, use the fcllowing job 
stream : 



(need if 



// 


JOB OLTEP 


// 


ASSGN 


SYS006,X'OOC' 




SYSRDR= 


=X'OOC') 


// 


ASSGN 


SYSPCH, im 


// 


ASS(3N 


SYSIPT,tm 


// 


ASSGN 


SYSLST, IGl^ 


// 


i^SSGN 


SYSRDR , uA 


/€ 







3. 



The unassigning of the units in the 
above job stream will depend on which 
Unit is to be tested. If the reader 
is to be tested and it is spooled by 
POWER, the unassigning cf SYSRDR 
should be the last statement. If 
SYSRDR has been unassign^d as above, 
no more cards will be read from the 
reader till the assignment is reset. 
Therefore, the fc Hewing should be 
keyed in through the ccnscle: 



// EXEC IJZAtOLT,REAL, {SIZE=nnk, 

where 14K is ninimuml 
r 01,'00C/TEST/OPT,PP(3)/' (Perform 

Cltep test) 
r 01,' CANCEL' (end CLIEP) 
// RESET SYSRER (resume reading 

cards frcm reader) 



Note: The DUMP verb and TR option 
will net work because cf the above 
SYSLST assignment cf IGN. 



To test unit record devices being used 
bY POWER use the fcllcwing job stream: 

// JOB CLTEP 

// PAUSE STOP EG AND ENTER 'Pxxyyy' 

(where XX=EG,F1,F2,F3,F4 and 
yyy=PUN,PRT,RER). 

// 

// EXEC IJZArOLT,REAL 

P (step) ccmmands are necessary to 
terminate present cperaticn of the 
device and are accepted by the 
Attention Routine (AR) . Multiple P 
(stop) ccmmands iray be necessary if 
multiple devices are being tested. To 
re-start the backgrcund enter the 
command ST^RT BG tc the next AR. 

Use // ASSGN stateirents to unassign 
devices as in Iteir 2. 

Note: Item 2 and 3 can be combined in 
most cas^s when POWER uses the same 
device as EG SYSLST, SYSPCH, SYSRDR. 



( 
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Figtnre 3^1 OLTEP Systeui Relationship Kith RETMN/370 Active 



Function 



Machine Configuration 






The Remote Technical Assistance Inforitiation 
NetWDrk for Systeni/370 (RETAIN/370) is an 
optional function of OLTEP that enables a 
remote specialist to control and/or monitor 
the online test and to analyze the results. 
It provides a three-way coirmunications link 
between the on-site IBM Custaner Engineer, 
a remote specialist, and OLTEP (Figure 
3-1). 

This OLTEP function can benefit the lEK 
Customer Engineer in analyzing system 
failures. It gives hiir the assistance of a 
highly trained and experienced specialist 
who may not be available on short notice at 
a custom,er location. 



RETAIN/370 Requirements 

You must meet the following requirements 
before you can include RETAIN/370 in the 
system, as part of OLTEP. 



• Systeir/370 Model 145 or 155. 



IBK 2955 Teleprocessing Control Unit 
with an IBM MCEEM housed internally 
(RPQ 858389). 



Terminal Adapter, Type I or II (feature 
4640) with a base speed of 600 bps 
(feature 95 82). 

A voice grade dial-up line with a data 
access arrangement device irast be 
supplied by the telephone company. 

A 3210-3215 or program compatible 
console must be assigned to the SYSLOG 
device . 

An optional 3 -channel manually operated 
switch can be installed to enable 
multiple systems to be tested by the 
remote specialist (RPQ 858388). 
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Skrftware Requirements 



System Generation 

If RETAIN/ 370 support is desired, FOPT 
RETAIN=Y1S must be specified at system 
generation time. Ihe default is FOPT 
RErAIN=NO. 



Main storage Requirements 

The RETAIN/370 Interface (REI> requires an 
additional UK in the background partition. 
Therefore^ you must allocate a real 
background partition of at least 18K if 
RETAIN/ 370 is to become active. Figure 3-2 
shov?s main storage allocation for OLTEP and 
the RETAIN/370 Interface. When OLTEP is 
initiated, the size equal parameter on the 
executive statement irust be a minimiim of 
18K. 



DOS Supervisor 



OLTEP 

Resident Area 
(nucleus) 



Transient Manager, tables, 
constants, etc . 



OLTEP 
Transient Area 

IJZADO02, 
IJZADO03, 
IJZACOMP, 

etc. 



OLT Area 

T2400A, 
T2400B, 
T23nH, 
More core area 
etc. 




Supvr 



li 



5K 



5K 



18K (minimum) 

Background 

Partition 



4K 
(minimum) 



Customer Problem 
Program Area 



Customer Problem 
Program Area 



F4 



F3 

1 



Main Storage 

Figure 3-2. CLTEP Storage Allocation With 
RETAIN/ 370 Active 
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Operation 



The on-site CE initializes OLTEP in the 
normal manner using the following JCI: 

// JOB OLTEP 

// ASSGN SYS005,X»cuu* (Assigns the IBK 

2955 TCU to SYS005> 
// ASSGN SYSnnn,X*cuu" (Assigns the device 

to be tested) 
// IXEC UZADOLT^REAL, [SIZE=NK3 (Minimimn 
18K) 
/♦ 
/g 

The on-site CE now enters R 01, 'REX' in 
response to the 01E105D message (ENTER 
EEV/TEST/OPT/). This causes the RETAIK/STO 
resident module to be loaded into main 
storage and become active. Once active, 
RETAIN/ 370 performs the following 
initialization : 



Message HandUng 

All messages to the on-site CE's SYSLST 
device also print on the remote 
specialist's console. The data-protection 
messages, such as those that require manual 
intervention, can only be answered by the 
on-site CE. 



When RETAIN/370 is active, a reply code 
of 03 is available for ccmiruni cation 
between the on-site CI and the remote 
specialist. You can enter this reply at 
any communicaticns interval without 
affecting the testing procedure. The 
format of this reply is : 



R 03, 'message to other operator" 



1. Checks for an IBM 2955 device 
assignment in the Physical Unit Block 
(PUB). 

2. Interacts with the operator to 
establish a teleprocessing connection 
with the remote analysis center. 

3. Sets internal flags in the supervisor 
to indicate RE'IAIN/370 is active. 

If this initialization is not 
successful, an error message occurs giving 
the reason for the failure. If it is 
successful, the 01E105D message is again 
issued. The on-site CE row enters the 
initial test-run definition. (Note that 
the RETAIN device must not be entered in 
the device field as a test device if RETAIN 
is active). If he enters RE as an option, 
OLTEP accepts subsequent entries from the 
remote specialist. 

The remote specialist can control the 
testing procedure by making entries in the 
test and option fields of the test- run 
definition. He can also request a dump, 
prompting, or terminate the RETAIN/370 
interface. If he requests a dump, it is 
printed on the on-site CE's SYSLST device. 

No Device Required (.NDR) is the only 
entry the remote specialist is allowed to 
make in the device field. To change a 
device address, he must return control to 
the on-site CE by entering NRE in the 
option field. The on-site CE then makes 
the change to the device field and returns 
control to the remote specialist by 
entering RE as an option. 

Note: Entry of .NDR by remote specialist 
prohibits him from doing any further 
testing on the device (s) originally 
allocated to him by the on-site CE. 



RETAEV/370 Termination 

Either the on-site CE or the remote 
specialist can terminate the RETAIN/ 370 
interface by entering R 01,'STOPREI' in 
response to a 01E105E iressage. It also 
terminates if a permanent teleprocessing 
error is encountered. In either case, only 
the RETAIN/370 interface is terminated. 



The on-site CE can terminate OLTEP after 
the FETAIN/370 interface is terminated. He 
does this in the normal manner by entering 
R 01, 'CANCEL' in response to the 01E105D 
message. 



Example of RETAIN/370 Operation 

You can use this example as a guide in 
running CLTEP while usirg the RETAIN/370 
featiare. 



On-site CE Activate IBM 2955 using meter 
key. 

Initialize OLTEP using the 
fcllcv?ing JCL: 

// JOE OLTEP 

// ASSGN SYS005,X'020' 

// ASSGN SYS001,X'181' 

(test device) 
// ASSGN SYS002,X'182' 

(test device) 
// EXEC IJZAD0LT,RIAL, CSIZE=NK] 

(mimimum 18K) 
/* 
/S 



4f 
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OLTEP 



> 






On-site CE 



OLTEP 



OLTEP is leaded. 

E102I OLTS RUNNING 

E13ai ^^RNING DASD VOLUME 

LABELED CEPACK NOT PROTECTED 

EROM WRITE 

E107I OPTIONS ARE NTL, NEI, 

NPR, FE^ NMI, EP, CP, PR, NRE , 

NTR 

01E105D ENTER DEV/TEST/OPT/ 

Call the reir.cte specialist from 
the data phcne, and go to data 
mode when he gives the signal. 

R 01,'REI' 

The RETAIN/370 interface is 
loaded and the initialization 
routines are perfcrmed. 

01E105D ENTER DEV/TEST/OPT/ 



On-site C£ R 01, '181/2400A/RE/' 



OLTEP 



Remote 
Specialist 

OLTEP 



Test section T2400A is 
performed en device 181. 
Subsequent input is accepted 
from the remote specialist. 

01E105D ENTER DEV/TEST/OPT/ 

R 01,V2400B-E//' 



Test sections T2400B through 
T2400E are run en the same 
device. 

01E105D ENTER DEV/TEST/OPT/ 



OLT EP The same tests are repeated, 
and control returns to the 
on-site CE. 

01E105E ENTER DEV/TEST/OPT/ 

On-site CE R 01,'18 2//RE/' 

OLTEP The same tests are performed on 
device 18 2, and the RE option 
causes control to return to the 
remote specialist. 

01E105D ENTER DEV/TEST/OPT/ 



Remote R 01,'/2400//' 
Spec ialist 



OLTEP 



Test secticKS T2400A through 
T2400Z are new run on device 
182. 



01E105E ENTER DEV/TEST/OPT/ 



Remo te It is determined that further 
Specialist testing is net necessary, and 
RETAIN/370 is terminated. 



R 01,'STOPREI' 



OLTEP The RETAIN/370 interface 

terminates, and eentrol returns 
to the on-site CE. 



Remote 
Specialist 



At this time it is determined 
that the same tests are to he 
run on device 182. 

R 03,«enter device 182' 

R 01, V/NRE/' 



01E105E ENTER DEV/TEST/OPT/ 



On-site CE Testing can Le continued or 

CLTEP terminated hy entering R 
01, •CANCEL'. 



> 
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DOS OLTEP Messages 



ElOOI 



(inf oriration frcir the OLT) 



The follovving messages, issued by OITEP, 
appear on both the message output device 
(SYSLST) and sthe console device (SYSICX5). 
The OLT iTiessages are not listed here, but 
you can find their in the writeup that comes 
with the individual test. OLT data prints 
on the SYSLST device only, unless you 
specify the parallel printer (PP) option. 



Note : SYSLST must be assigned to a 



printer, a tape, or IGN. 



The message format is : 



EG rrEnnnt 'message text" 



where 



EG Appears only when OLTEP is running in 
a multiprogramming envircranent- The 
EG indicates that the message pertains 
to the background partition in which 
OLTEP operates. 

rr Is the reply code tc use when 

responding to messages that require an 
immediate reply (D type). The codes 
are : 

01 ~ For the 01E105D message. 

03 - RETAIN/370 only. Used for 

communication between the on-site 
CE and remote specialist. 

04 - For all other OLTEP and OLT 

messages. 

E Indicates that the Executive program 
(OLTEP) is issuing the message. 

nnn Is the three-digit message number. 

t Is the message type cede where, 

I Indicates an informational 

message that requires no reply. 

E Indicates a decision message 
requiring an immediate reply. 

An examiple of a reply is: 
EG R 4, 'YES" 

where EG is printed by the system if 
operating in a multiprogramming 
environment, and R 04, 'YES' is entered by 
the operator. 

The following messages can occur during 
execution of DOS OLTEP: 



C ause : This message contains 
information that is passed from the 
test section tc the operator. 



System Action: Testing continues. 

Operator Acticn: Net applicable. 

Cause: The test section requests 
information from the operator. 

System Action: Net applicable. 

Operator Acticr: Enter the 
requested infcrmatien. You may 
need to refer to the writeup that 
accompanies the OLT. 

04E101D (request from OLT) 

Cause: The test section requests 
information frcn the operator. 

S ystem Action : Net applicable. 

Operator Actic r: Enter the 
requested information. You may 
need to refer to the writeup that 
accompanies the OLT. 



( 



E102I 



OITS RUNNING 

Cause; The OLTEP program was 
leaded. 



System Action : 
continues. 



Processing 



Operator Action: Net applicable. 

01E105D ENTER-EEV/TEST/OPT 

Cause: This is a request for ycu 
tc define the testing procedure, 
that is, specify the device (s) to 
test, test (s) to run, and options 
to exercise. It also gives you the 
opportunity tc cancel OLTEP, EUMP 
the background partition, or 
request prompting, REI, or EQUATE. 

System Action: Not applicable. 

Operato r A ction: Reply with the 
requested information. If entering 
a test-run definition, each of the 
three fields must be delimited by a 
slash (/) and must conform to the 
syntactical rules in R unning the 
Tests . This message oecurs at the 
initial communication interval to 
allow ycu to define the testing 
procedure and at subsequent 
communication intervals to provide ^ 
for changing the testing procedure. J 
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E106I 



) 



field entries are required. Any 
option not specified causes the 
default for that option to apply. 



At later coiriruni cation intervals, 
only those iteirs that are to change 
require entries. A device field or 
test field consisting of only a 
slash causes the previous entry in 
that field to apply. The device 
address roust be reentered if the 
device was bypassed in the previous 
run. Any option not specified 
causes the previously specified 
option to apply. 

At any coirirunicaticn interval, a 
response of R 01, 'CANCEL' 
teririnates OLTEP- A response of R 
01,'EUiyiP' causes the background 
partition to be printed. 

The R 01, 'PROMPT XXX' reply (DEV, 
TEST, or OPT) causes OLTEP to print 
an exair.ple of the field specified. 
An R 01, 'PROMPT ALL' cr R 
01, 'PROMPT' reply causes examples 
of all three fields to be printed. 

Ecr RETAIN/370, a reply of R 
01,'KEI* to iressage 01E105D by the 
cn-site CE after OLTEP has been 

loaded will cause the RETAIN/370 
interface to be loaded and 
initialization routines to be 
perfcrnied* If it is determined 
that further testing is not 
required^ and RETAIN/370 is to be 
teririnated, a reply cf R 
01,'STOPREI' to iressage 01E105D 
v^ill cause RETAIN/370 interface to 
be terminated and ccntrcl returned 
to the on-site CE. 

A reply iressage R 01, 'TALK' by 
the CE in response tc message 
01E105E will initiate dynamic CE 
communications with the OLT if the 
OLT does in fact support such 
communications . 

A reply message of R 01, 'EQU' in 
response to message 01E105D will, 
if an OLT is active, cause it to he 
terminated. Then message 04E394D 
will be issued tc allow the 
operator to enter equates. At the 
next communication interval a 
device file entry is mandatory. 

INPUT DATA DOES NOT CONTAIN 3 
SLASHES 

Cause : Your reply tc miessage 
01E105D, or the test-run definition 
card, contained more cr less than 
the required three slashes. 



This is probably a user error. 

S ystem Action; The 01E105E message 
follows if a ccnscle is available. 
If nc console is available, OLTEP 
terminates. 

Operator Actio n; Check for 
embedded blanks in the test-run 
definition. If the test-run 
definition is being entered by 
card, correct the card and 
reinitiate OLTEP. If the problem 
recurs when the input is known to 
be correct, do the fcllowing: 

• Initiate a ccnscle request and 
respond 'CANCEL' tc the 'READY 
FOR COMMUNICATIONS' message. 
This causes a DUMP. 

• Bave the ccnscle ar^d DUMP 
listings available. 



El 071 CPTICNS ARE XXX, XXX, etc. 

Cause ; Indicates the test options 
that are in effect at the time the 
message is issued. It occurs 
immediately before a 01E105D cr 
E250I message. 

System Action; Not applicable. 

Cperatcr Acticr ; Net applicable. 



E108I 



INVALID ENTRY IN DEV ELD- XXXXXXXX 



Cause: 



An error was 



the device field cf y 
the 01E105D message c 
definition card. The 
indicate the pcrticn 
that contains the err 
errors include; inva 
cr device address, fi 
invalid range cf devi 
exceeds 16 devices. 



detected in 
cur reply to 
r test-run 

XXXXXXXX 
of the field 
cr. Possible 
lid delimiter 
eld omittedy 
ces^ cr range 



This is probably a user error. 

System Action; This m-essage is 
followed by the E161I and 01E105D 
or if card input, the next card is 
read. 

Operator Action; Make a correct 
entry. If the problem recurs when 
input is known tc be correct, do 
the fcllowing; 

• Initiate a ccnscle request and 
respond 'CANCEL' tc the 'READY 
FOR COMMUNICATIONS' message. 
This causes a DUMP. 

• Have console and DUMP listings 
available. 
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EllOI TESTATABLE DEVICES MAY NOT EXCEED 
16 

Cause : You have selected more than 
sixteen devices. Only the first 16 
are tested. The reiraining device 
entries are skipped. 

This is probably a user error. 

System Action : Not applicable. 

Operator Action ; If you desire to 
test more devices, specify them in 
your reply tc the next 01E105D 
message. 

ElllI NO DEVICES AVAILABLE FOR TEST 

Cause: None of the devices entered 

can be used as a test device. A 

device cannot be used as a test 

device if it is: 

(1) Not assigned tc the 
background? or 

(2) Symbolically Earned and has 
no CDS: cr 

(3) A unit record device 
assigned to SYSIPT, SYSRDR, 
SYSLST, cr SYSPCH, and PCWER 
is active - 

This message will be preceded hy 
message E127I, E234I, cr E235I. 

System Action : The 01E105D message 
follows. 

Operator Acticn : Refer to E127I or 
E234I or E235I message descriptions 
as applicable. 

E112I INVALID ENTRY IN TEST FLD-XXX^XXXX 

Cause : An error was detected in 
the test field of your reply to the 
01E105D message cr in the test-run 
definition card. The XXXXXXXX 
field contains the error and can te 
up tc 8 characters. The error may 
be one of the fcllcwing: invalid 
delimiter, field omitted, invalid 
test type (does not contain all 
digits) , invalid test section (name 
not alphabetic), invalid range of 
test sections, invalid 
specification of test section 
routine (m.ore than one test section 
specified), invalid test section 
routine, invalid range of test 
section routines, or invalid test 
ID prefix. 

System Action : The E161I and 
01E105D messages f cllcWe OLTEP is 
terminated if no ccnscle is 
available. If card input next card 
is read. 



Opera tcr Acticr: If the test- run 
defiDiticn is entered en card, 
correct the test field and 
reinitiate OLTEP. If the problem 
recurs when input is known to be 
correct y do the fcllcwing: 

• Initiate a ccrscle request and 
respond "CANCEL' tc the 'READY 
FOR COMMUNICATIONS' message. 
This causes a DUMP. 

• Have console and DUMP listings 
available. 

04E113D CAK CTL PGM ON MULTI-AEDR EEV XXXX 
BE DESTROYED REPLY YES/NO 

Cause: The device XXXX is to be 
selected for test. Its type and 
class indicate it is programmable 
and that it prcbably responds tc a 
set cf unit addresses. If the test 
secticn is allowed tc proceed 
(reply cf YES) , the ccntrcl program! 
in the device may he destroyed. 
The operator may have to reset the 
device after testing. A reply cf 
NC will cause testing tc be 
bypassed on that device. 

System Action; Net applicable. 

Op erator A cticn: REPLY YES tc test 
the device or NO tc not test it. 

E115I IKVAIIE ENTRY IN OPT ELE-XXXX 

Cause; An error was detected in 
the option field cf your reply to 
the 01E105E message cr in the 
test-run definition card. The XXX 
field indicates the entry in error. 
This message alsc occurs if the RE 
option is entered when RETAIN/370 
is net active. 

This is prcbably a user error. 

System Action: The E161I and 
01E105D messages fellow. OLTEP is 
terminated if no ccnscle is 
available. If card input next card 
is read. 

Operator Action; If the test- run 
definition is entered en card, 
correct the option field and 
reinitiate OLTEP. If the problem 
recurs when input is known to he 
correct, do the fcllcwing: 

• Initiate a ccnscle request and 
respond 'CANCEL' tc the 'READY 
FOR COMMUNICATIONS' message. 
This causes a DUMP. 

• Bave console and DUMP listings 
available. 



( 



f 
% 
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1117 I SECTION XXXXXXXX NOT FOUND 

Cause: The test section indicated 
b]^ XXXXXXXX cannct be fcund. 

Systeici Action ; Testing proceeds 
vvith the next text section. 

Operator Action : Check for an 
invalid entry in the test field or 
catalog required OLT. 

E118I UNREADABLE TAPE LABEL XXXX 

Cause: A unit check was received 
en trying to read the tape label. 
The XXXX field is the device 
address. 

System Action ; The E137I and 
04E139D messages follow. 

Operator Action : Reply to the 
04E139D message that fellows. 

E119I NON-STANDARD TAPE LABEL XXX 

Cause: The tape that is mounted on 
device XXXX does net have a 
standard label. 






System Action ; 
fellows. 



The E139D message 



Operator Action ; Reply to the 
E139D message that fellows. 

04E120D CAN VOL DATA ON XXXX BE DESTROYED. 
REPLY YES OR NO 



E124I 



System Action; The E139D message 
will fellow. 

Operator Be spcnse; Net applicable. 

CEPACK NO ON XXXX [WOLID = XXXXXX] 



Cause: 



Either the VOL 1 label is 



not present or the serial numiber is 
not CEPACK on a demountable disk. 



System Action : 
fellows. 



The 04E139E m.essage 



Operato r Action; Reply to the 
04E139E message that follows. 

E125I UNREADABLE LABEL ON XXXX 

Cause; A unit check was received 
while attempting to read the label 
on a demountable disk device. XXXX 
is the device address. 

This is probably a user error. 

Syst em Actio n: The E137I and 
04E139E msessages fellow. 

O perato r Acticn; Net applicable. 

E126I BIN OF XXXX DOES NOT INDICATE CE 
CEIL 

Cause; The CE bit in subcell 18 
C2321) is off, or CE bit in subcell 
19 is en. XXXX is the device 
address . 



E122I 
E122I 



% 



Cause: The device test section 
requested space en DASD for write 
operations. XXXX is the device 
address. 

System Action ; Not applicable. 

Operator action ; Reply R 04, 'YES' 
or R 04, 'NO'. 

Note: If you reply R 04, 'YES*, the 
pack must be reformatted before it 
can be used by the system. 

VOL ON XXXX SECURITY PROTECTED 

VOL ON XXXX UNEXPIRED DATE 

Cause : For the first form, byte 11 
of the tape or disk Veltime Label is 
not hex 'FO', *00', or '40' (or for 
ASCII tape label, net hex '30', 
•00', or •20".) Fcr the second 
form>, the expiration date on a tape 
volumie is greater than the date in 
the communication region. 



System Action; The F137I and 
04E139E msessages fellow. 

O perator Acti on: Net applicable. 

E127I NO CDS FOR XXXXXXXX 

Cause; The requested test device 
(XXXXXXXX) CDS (Configuration Data 
Set) cannot be found in the cere 
image library. 

Note; (XXXXXXXX=f eur digit unit 
address or 1-8 character symibclic 
name ) . 

S ystem Actio n: Testing of the 
device is bypassed. Message E231I 
follows if the device was entered 
as a physical device address rather 
than a symbolic name. 

Operator Acticn; Check for an 
invalid device address or use 
equate function or ereate a CDS for 
the requested device. 
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PIRST ERROR COMM XXXXXXXX YY^Y UNIT 
ZZZZ DDEDDDDD 

Cause: This iressage identifies the 
first error coipiriuni cation interval. 
The XXXXXXXX is the test section 
being executed, the YYYY field is 
the routine in which the error 
occurred, the ZZZZ field is the 
address of the test device, and 
CEBDEDDD is the 1-8 character 
syitibolic name (if applicable) . 



E134I 



System Action ; 
follows. 



The 01E105D message 



Operator Action : Reply to the 
01E105D message that follows. If 
your reply does not include a 
device or test change, the test 
continues from where the error was 
detected. 



E130I INTIRVHSITION REQ XXXX 

Cause: The data-protection routine 
has determined that intervention is 
required on the device whose 
address is XXXX. 

System Action : The E137I and 
0aE139D messages follcw. 

Operator Action : Take corrective 
action and reply to the 04E139D 
message that follows. 



E131I SENSE TO XXXX FAILED 

Cause: Unsuccessful sense to 
subcell 18 or 19, bin of a 2321, 
XXXX is the device address. 

This is probably a hardware error. 

System Action : The E137I and 
4E139D messages follcw. 

Operator Action : Net applicable. 



1371 



E138I 



WARNING - EASE VOLUME LABELED 
CEPACK NOT PROTECTEE EROM WRITE 

Cause: The OLTEP program was 
loaded. 

System Action : Processing 
continues. 

Operator Action: Eefcre responding 
to the 01E105E message with a disk 
address of a user pack, ensure that 
it does not have a vclume 
identification of CEPACK. Test 
sections may destroy data on EASDs 
with a volume identification of 
CEPACK without issuing subsequent 
messages. 

CSW - XXYYYYYYYYYYYYYY SNS 
XXXXXXXXXXXX 



Cause: 



The XX... X and YY. 



fields are the sense and CSW data 
received. The high-order byte of 
the CSW is replaced with xx, 
because it is not accurate. 

Sense length printed will vary with 
device type. Any trailing bytes 
containing hex ^ IF* will not be 
printed. 

Sense data will be printed only on 
occurrence of unit check. 

System Action: The 04E139E or 
E226I message follows. 

Operator Action: Not applicable. 

DEV XXXX NOT OPERATIONAL, CC=3 

Cause: TIO or sense to test device 
by data protection resulted in 
condition code 3. 



System Action : 
issued. 



message 04E139D is 



Op erator Action : Check to see that 
the device address exists on the 
system and that the device is on 
line. 



1 






E132I CE BIT WILL NOT BE RESET — XXXX 

Cause: A sense to subcell 19, bin 
of a 2321 indicates the CE bit is 
on when it should be off. XXXX is 
the device address. 

This is probably a hardware error. 

System Action : The El 3 71 and 
4E139D messages follow. 

Operator Action : Not applicable. 



04E139D REPLY B TO BYPASS, R TO RETRY, P TO 
PROCEED (MAY EESTROY EATA) 

Cause: This message follows the 
data -protection messages when 
data -protection measures have not 
been met, or if the attempt to 
restore a tape label was 
unsuccessful. The PROCEEE option 
is omitted if the message occurs 
when restoring a tape label, 
testing a 2321 device, or a 
security-protected vclume is 
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recognized. The part in 
parentheses appears fcr tape 
devices only- 



SysteiB Action : Not applicable. 

Operator Action : Reply one of the 
following: 

R 4, 'B'- Bypass testing of the 
device. The 01E105D 
message fcllcws. 

R 4, 'R'- Retry the test. If the 
device was net read^-, 
nake it ready; if a CE 
voluire is needed, mount 
it befcre replying. 

R 4, 'P'- Proceed testing on the 
device [direct access 
device testing proceeds 
in file protect mode 
(FPM) ] . 

04E145E IS XXXX OFF LINE TO ALL SHARIKG 
SYSTEMS? REPLY YES OR NO 

Cause: This message appears v^hen 
the EASE device is capable of being 
shared between CPU's. It wants to 
know if the device is being shared 
at the present time. 

Systemt Action : Not applicable. 

Operator Response ; Tc allow the 
allocation request tc be satisfied, 
enter R 04, 'YES*. Tc inhibit 
allocation, enter R 04, 'NO". 
After a NO reply, OLTEP will 
continue testing in file protect 
mode and will net allcw any writing 
en the device. 



E147I 



EXAJyiPLES OF EEVICE FIELD 



0181/ 
0185-0187/ 

CHICAGO 1 

285-286, 

18 4/ 
.NER/ 

/ (SLASH 

ALONE) 



TEST DEVICE 181 

TEST DEVICES 185,186, 

+ 187 

TEST SYJ^BOLIC TP 

DEVICE, CHICAGOl 

TEST DEVICES 285, 

286, and 184 

NO DEVICE REQUIRED 

FOR TEST 

TEST PREVIOUSLY 

SELECTED DEVICES 



Cause: These examples of device 
selection appear when you reply to 
the 01E105D message with R 
01, 'PROMPT DEV, R 01, 'PROMPT AIL', 
or R 01, 'PROMPT'. 



M 



Operator Acticn; Net applicable. 
El 4 81 EXAMPLES OF TEST FIELD 



System Action : 
follows. 



The 01E105D message 



E149I 



E149I 



E149I 
E149I 
E149I 
E149I 



2400/ TAPE TESTS 

2400A/ SEC. A OF TAPE TEST 

2400 
2400C,2/ RTN 2, SEC. C, TEST 

2400 
2400A-C,E,G/ SEC. A,E,C,E, + G OF 

TEST 2400 
R254 0AA/ SEC. i^A OF READER 

TEST 2540 
/ (SLASH RUN PREVIOUSLY 
ALONE) SELECTEE TESTS 

Cause: These examples of test 
selection appear when you reply to 
the 01E105E message with R 
01, 'PROMPT TEST', R 01, 'PROMPT 
AIL', or R 01, 'PROMPT'. 



System Action; The 01E105E message 
fellows. 



Operator Action; Net applicable. 



E149I 


TAELE OF 


OPTIONS 






E149I 


OPTION 


TO REQUEST 
OPTION 


TO OMIT 
OPTION 


BY 
DEFAU] 


E149I 


TESTING 


TL 


NTL 


NTL 




LCCP 


TL (VALUE) 


VALUE=1- 


-32767 


E149I 


ERRCR 


EL 


NEL 


NEL 




LCCP 


EL (VALUE) 


VALUE=1- 


-32767 


E149I 


ERRCR 
PRINT 


EP 


NEP 


EP 


E149I 


CCNTRCL 
PRINT 


CP 


NOP 


CP 


E149I 


PARAL- 


PP 


NPP 


NPP 




LEL 


PP (LEVEL) 


LEVEL=1- 


-3 




PRIN^ 








E149I 


PRINT 


PR 


NPR 


PR 


E149I 


FIRST 
ERRCR- 
CCKMUN- 
ICATICN 


FE 


NFE 


FE 



NMI 



MANUAL MI 
INTER- 
VENTICN 
REMOTE RE 
FE 
CCM'RCL 
TRACE TR 
EXTERNAL EATA EXT= 
EXAMPLES OF OPTION FIELE 
PP,NMI,RE/ 
EP ,TL (50 ) , FE , EXT=A , E/ 



NRE 



NTR 



NMI 



nre 



NTR 
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Cause: This table appears v?hen :you 
reply to the 01E105D message \tith R 
01, 'PROMPT OPT\ R 01, "PROMPT All', 
or R 01, 'PROMPT •• 



System Action : 
follows. 



The 01E105D message 



Operator Action : Not applicafcle. 

Note : If you reply tc the 01E105D 
message with R 01, 'PROMPT All* or R 
01, 'PROMPT', all three messages 
(E147I, EiaSI, and E149I) appear. 



E155I TEST SECTIONS MAY NOT EXCEED 26, 
WILL TEST XXX- XXX 

Cause: The nuirJoer of unit test 
sections you requested exceeded 26. 

This is probably a user error. 

System Action ; The first 26 
sections entered are processed. 

Operator Action ; If you desire to 
run more sections, enter them in 
your reply to the next 01E105D 
message. 

If this message occurs when there 
are less than 26 test sections, 
check for an errcr in the entry, 
such as a dash being where a comma 
is meant to be. Multiple entries 
of the same test section are 
counted as part of the 26 maximum. 



E161I 



while running a test section or 
that the secticn did net run tc 
completion due tc a change of 
device cr test at first error 
conirunicaticn, catastrophic error 
coirirunicaticn, cr external 
interrupt comirunicaticn interval. 
BEDDDEEE is the 1-8 character 
symbclic name if a device was 
entered as a symbclic name- The 
dollar sign ($) appears only for 
special tests. See Special 
Operating Consi deraticns . 

If the NOP cpticn is in effect, 
this message dees net appear 



System Action; Net applicable. 



Operator Action ; Net applicable. 

FOR HELP, ENTER PROMPT XXXX TO NEXT 
DEV/TEST/OPT/ MESSAGE 



Cause: 



An errcr was made in 



response to the 01E105E message. 
The XXXX field contains DEV if the 
errcr is in the device field, TEST 
if the error is in the test field, 
cr OPT if the errcr is in the 
option field. A reply of R 
01, 'PROMPT AIL' cr R 01, 'PROMPT' 
the 01E105E message results in 
printing examples ef all three. 

This is probably a user error. 



to 



( 



4 



E157I 



E158I 



CATASTROPHIC ERROR ON DEVICE XXXX 
EEDEECBD 

Cause ; An error was detected and 
the OLT has indicated that further 
testing is not worthwhile. XXXX is 
the device address. DDDDDDDD is 
the 1-8 character symbclic name if 
a device was entered as a symbolic 
name. 

This is probably a hardware error. 



System. Action ; 
follows. 

Operator Action : 
E10 5D message. 



The 01E105D message 



Reply to the 



T XXXXXXXX $ UNIT YYYY DDDDDDDD 
*T 

Cause ; Execution of the test 
section (XX... X) started (S) or 
terminated (T) on unit YYYY. * 
indicates that an errcr occurred 



System Action: The 01E105E message 
f cllcws. 

Opera ter Action ; Net applicable. 

E163I RETAIN/370 READY 

(RETAIN/370 only) 

Cause; OLTEP has established 
contact with the remote specialist. 

System Action ; Messages E107I and 
01E105D follow. If the CE does not 
change the device or test fields 
when responding tc the 01E105E 
message, the previcusly entered 
test-run definitien is rerun frcm 
the beginning. 

Cperater Action: Net applicable. 

E164I CANNOT LINK TO RETAIN 370 - 

RETAIN = YES MUST EE SYSGENED 
SYS005 IS NOT A 2955 UNIT 
CONSOLE KEYBOARD IS NEEDED 
MINIMUM 18K NEEDED EY EG 
INITIAL REMOTE RESPONSE TIMEOUT 
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Cause: One cf the fell owing as 
specified in the variable portion 
of the message: 

1. The supervisor being used was 
not generated with RETAIN = 
YES SYSGEN option. 

2. SYS005 is not assigned or is 
assigned to a device other 
than a 2955. 

3. SYSLOG is not a console 
keyboard. A console is needed 
to coitimunicate with the remote 
specialist. 

4. BG partition is less than 18K 
of real core. This is the 
minimum size required to 
support RETAIN. 

5. The initialization message 
from the remote specialist has 
not been received in the 10 
minutes allowed for the 
response. 



System Action ; Messages E107 and 
01E105D will follow. 



Operator Action : If the message is 
"INITIAL REMOTE RESPONSE TIME OUT " , 
inform the remote specialist then 
re-enter 'REI' to message 01E105D 
to retry. For the ether 
conditions, cancel OLTEP, correct 
the condition and reinitialize 
OLTEP and retry. 

E165I ENTRY IN DEV FLD NOT ALLOViABIE By 
REMOTE 
(RETAIN/370 only) 

Cause: The remote specialist 
attempted to make a device entry in 
the test -run definition. 

System Action ; Messages E107I and 
01E10 5D follow. 



El 671 PERMANENT ERROR ON REI DEVICE 
(RETAIN/370 only) 

Cause: A teleprocessing error 
occurred while performing an I/O 
operation on the Retain 370 data 
link. 



Sy stem Action : The teleprocessing 
line is disabled and messages 
E137I, E169I, E107I, and 01E105D 
are issued. Message E169I is not 
issued if the error occurred while 
making initial contact with the 
remote analysis center. 

Operator Action ; Not applicable. 

E169I RETAIN/370 TERMINATE! 

(RETAIN/370 only) 

Cause: OLTEP terminated the line 
connection with the remote analysis 
center. 



System Action : 
01E105D follow. 



Messages E107I and 



Operator Action; Not applicable. 

El 7 01 KG PREVIOUSLY SELECTEE DEVICE/TEST 

Cause: The operator attempted to 
default to previously entered 
device (s) or test(s) when none had 
been accepted. 

System Action: Not applicable. 

Operator Action: Make an 
acceptable entry in the device on 
test field in response to the next 
01E105E message. 



E174I 



UNABLE TO RESTORE LAEEL ON EEVICE 
XXXX 






Operator Action ; If a device 
change is desired, control must be 
returned to the on-site CE. To do 
this, enter NRE as an option in 
response to the 01E105D message. 

E166I OLT DOES NOT SUPPORT TALK 

Cause: This message appears if you 
have entered the verb 'TALK' in 
response to message E105D and the 
OLT does not support ccmmimication 
with you. 

System Action : Processing 
continues at the point of 
interruption . 

Operator Action ; Not applicable. 



Cause: The Write was unsuccessful 
when attempting to write a label 
after testing a tape device. 

This is probably a user error. 

S ystem Actio n: The El 37 I and 
04E139D messages fellow. 

Operator Action: Ccrrect condition 
causing error if possible and 
respond to 04E139D. 



01E175D SYNTAX ERROR 
04E175D SYNTAX ERROR 



Cause: The reply to a two-way 
message was not in the expeoted 
format. 
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This is probably a user error. 



System Action : Not applicable. 

Operator Action s Reenter the reply 
to the message. 

E176I MUTUALLY EXCLUSIVE OPTIONS HAVE 
BEEN SELECTED 

(RETAIN/370 only) 

Cause: One of the fcllov?ing 
occurred : 

• The RE and MI options were both 
entered by the on-site CE. 

• The on-site CE entered RE while 
the MI option was in effect. 

• The remote specialist entered the 
MI option. 

System Action : Messages E107I and 
01E105D follow. 

Operator Action : Enter the desired 
options in response to the 01E105D 
message that follows. It is not 
necessary to reenter the device and 
test fields. If the option field 
is not changed, the options 
specified in the previous test-run 
definition are used. 

04E197D MOUNT XXXXXX, REPLY DEV ADDR OR ^X 
TO BYPASS 

Cause : The unit test requested 
that test data be read from the 
READD data set. 

Systemt Action : Not applicable. 

Operator Action : Mount the volume 
on an available tape unit or card 
reader and enter its 3- or 4-digit 
address. If there is no unit 
available, enter R 04, 'NO*. 

E198I NOT ALL ROUTINES SELECTED IwERE RUN 



Cause: The response to a 'D* type 
message was invalid. 

This is probably a user error. 



System Action: Net applicable. 



Operator Acticns Reenter the reply 
to the *D' type message. 

E201I DEVICE DESCRIPTORS DC NOT MEET 
XXXXXXXX REQUIREMENTS 

Ca use : The device and test ycu 
requested were ret compatible. 
XXXXXXXX is the test section. 

This is probably a user error. 

s ystem Action : Any remaining 
devices or tests are scheduled. 

Operato r Action: Check for an 
invalid entry in the test- run 
definition. If the test- run 
definition is kncwn to be correct, 
the Customer Engineer should check 
for an incorrect configuration data 
set for that device. 

E210I ROUTINE XXXX BYPASSED, MANUAL INTV 
REQUIRED 

Cause: You selected a routine 
requiring manual intervention 
without selecting the MI option. 

System Action: Testing continues 
with the next routine. 

Operator Action: Rerun the test 
with the MI option selected. 

04E221D CAK FOREGROUND BE QUIESCED, REPLY 
YES CR NO 

Cause: The test section requested 
a function requiring that no new 
jobs be started in the foreground 
partitions after the current jobs 
reach EOJ. 



c 



'K 



Cause ; 



Non-existent routines were 



requested or OLT terminated 
abnormally. 

This is probably a user error. 

System Action : Remaining test 
sections are scheduled. 

Operator Action : Check for an 
invalid test field entry or if 
E158I has ♦ check SYSLST. 

04E199D INCORRECT REPLY 



System Action : An R 04, 'NO' reply 
causes the test section to be 
informed that the requested 
function is not available. An R 
04, 'YES' reply causes message E222I 
to be issued. 

Operator Action; Reply R 04, 'YES' 
if the foreground partitions can be 
stopped when the current jobs reach 
EOJ. Reply R 04, 'NO' if they 
cannot be stopped. If you reply 
R 04, 'YES', and do not quiesce the 
partitions, OITEP cannot continue. 
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E222I STOP FOREGROUND JOBS 



Cause : You replied R 04, 'YES • to 
the 04E221D iressage. 

System Action : E233I is issued 
\vhen the systeir is successfully 
quiesced. 

Operator Action ; Batched job 
processing . Press the Request key 
and respond to the 'READY FOR 
COMMUNICATIONS' iressage mth 'PAUSE 
FX,EOJ". (Where X is the niMnfcer of 
each active foreground partition.) 
Issue the next pause ccmmand for 
all active foreground partitions. 
As each partition ccirpletes, the 
area with the prefix FX is printed 
respond with the operator coinirand 
•STOP' after each. 

Single Prograir Initiation . Do not 
initiate any ircre foreground jofcs 
until the test field is changed in 
response to the 01E105D message. 

Note: OLTEP will net continue 
until the foreground partitions are 
no longer active. 

OLTEP TH^MINATED. CONSOLE EEYBCARD 
UNAVAILABLE 

Cause : A console device was not 
available for input data required 
by OLTEP at a coiriruni cations 
interval. 

System Action : OLTEP is 
terminated « 

Prcg rairEiur Action ; Net applicable. 

Operator >^ction ; Net applicable. 



E226I 



E227I 



E229I 



fi^s": 



„ :,iJT SUPPORT FOR 
-01 



Cause J A test section required a 
higher SCT level than supported by 
OLTEP. XXXXXXXX identifies the 
test section. 

System Action : The OLT is bypassed 
and the next test section is 
scheduled. 

Operator Action : Not applicable. 

SECTION XXXXXXXX CANCELED FOR J^/CDE 
REQUEST 

Cause : Mode requirements from the 
OLT are not supported by OLTEP. 
XXXXXXXX is the test section 
requesting the mode. 



E230I 



E231I 



E232I 



E233I 



System Action: The requesting 
section routine is canceled. 



Oper ator Acti on; Net applicable. 



OLTEP CANCELED - SYSLST AS DASD NOT 
SUPPORTED 

Cause: The device assigned to 
SYSLST is a direct access device. 
OLTEP does not support disk as a 
SYSLST device. 



System Action ; 
terminated. 



OLTEP is 



Op erator Acti ons Assign SYSLST to 
a tape or printer and initialize 
OLTEP. 



XXXXXXX CANNOT RUN ON YYYY 

Cause: This message is preceded by 
a message that explains why test 
XXXXXXXX cannot be run on device 
XXXX. The preceding miessage is 
E127I or E201I. 

System Action: Test XXXXXXXX is 
bypassed, and OLTEP attempts to run 
the next test en the same device if 
another test was specified. 

Operator Acticn; Net applicable. 

CLTEP CANCELED - EG PARTITION LESS 
THAN 14K 

Cause; The real EG partition size 
is less than the 14K required to 

run CLTEP. 

System Acticn; OLTEP terminated. 

Operator Action; Expand the 
background partition to at least 
14K through operator comrounication 
or make SIZE= at least 14K. 

DC NOT INITIATE ANY FOREGROUND JOBS 

Cause; The foreground partition 
was quiesced due to a request from 
the test section. 

System Action; Not applicable. 

Program mer Acticn: Not applicable. 

Operator Action: Do not initiate 
any jobs in the foreground 
partitions until the current 
test-run definition is changed, or 
testing is terminated. 
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12341 DEVICE XXXX NOT TESTED. NO LOGICAL 
UNIT ASSIGNMENT 

Cause: The device entered in the 
last test-run definition is not 
assigned. 

System Action : The device is not 
tested. 



E238I XXXXXXXX EYPASSEE-CORE NOT 
AVAILABLE 

Cause: A test section requires 
DTore irain storage than there is 
available. 

Systeir Action : The next test 
section is run. 



( 



Operator Action : Assign the device 
to be tested and re-initiate CLTEP. 



E235I DEVICE XXXX NOT TESTED. 
ACTIVE 



POIWER 



Operator Action: Check the Writeup 
that accoirpanies the test to 
deteririne the additional main 
storage required. Increase the 
size of the real background 
partition if you desire to run this 
test section. 



Cause: POWER may be spooling I/C 
to the device. 



System Action : The device is not 
tested. 



Operator Action : De-activate POWER 
and re-enter the device. But 
first, read section Running OLTEP 
With Power. 



E239I KEYBOARD UNAVAILABLE 

Cause: OLTEP required two way 
coiriruni cation and SYSLOG was not a 
keyboard console. The message that 
required a reply is printed before 
this message. 

System Action : If a data 
protection message is issued, the 
next device is scheduled. If an 
CLT is active, the CLT is reset and 
the next test is scheduled. 



E236I XXXX IS A TEST DEVICE - CANNOT BE 
USED 

Cause: Device XXXX, that was 
entered in response to the 04E197D 
or 04E324D message, is a test 
device. It cannot be used for the 
READD or history data set. 



System Action : The 04E197D or 
04E230D message is issued again. 



Operator Action : Mount the history 
tape or READD data set on a 
different device and enter its 
address, or enter R 04, 'NO*. 

E237I DEVICE XXXX HAS NO LOGICAL UNIT 
ASSIGNMENT 

Cause: The device address entered 
in response to message 04E197D or 
4E324D is not assigned to the 
background partition. 



System Action : Message 04E197D or 
4E324D is issued again. 

Operator Action : Either cancel 
OLTEP, assign the device and rerun 
the test, or mount the data set on 
a device that is already assigned 
and enter its address. 



Operator Ac tion: If applicable, 
correct the situation which causes 
the message and initialize OLTEP to 
rerun the desired test sequence. 

E241I LCST DATA - RE-ENTER MESSAGE 

(RETAIN/370 only) 

Cause: The remote specialist 
entered more than one message 
during a period when messages were 
not being processed. Only the 
first message was accepted. 

System Action: Net applicable. 

Operator Action: Wait until the 
first message is pxccessed, then 
reenter the lost messages. 

E242I EQU NOT ALLOWED FROM REMOTE 
(RETAIN/370 ONLY) 

Cause: The remote specialist 
requested EQU which is allowed only 
by the on-site operator. 



\. 



S ystem Action : 
re -issued. 



Message 01E105D is 



Operato r Action: Remote Specialist 
should make a valid EEV/TEST/CPT/ 
entry or respond with the NRE 
option to allow on site operator to 
enter equates. 
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04E24 3E WILL CPU SHARED DEVS BE USED B^ 
OTBIRS, REPL^ YES OR NO 

Capse ; Control Unit Testing may 
yield unexpected results to any 
other CPU using the tested control 
unit. Ihis iressage is preceded fcy 
message E244I, listing CPU Shared 
Devices on that contrcl \mit. 

Systein Action s Not applicable. 

Operator Action ; Reply R 04, 'YES' 
if any of the listed devices ^ill 
be accessed by another CPU v«hile 
the present test section is active. 
Otherwise reply R 04, 'NO*. 

E244I TEE FOLLOWING CU TEST DEVS ARE: 

CPU SHARED 

NOT ASSIGNED TO BG 

SYSTEM DEVS 

Cause : While attempting to run a 
control unit test, at least one 
device on the test control unit was 
found to be a CPU sharable device, 
not assigned to the background, 
required by the system, i.e., 
SYSRES, SYSLOG, SYSLST, SYSREC or 
SYSCLB partition, iressage, all 
lines after the first being a list 
of the devices affected. 

System Action ; If the devices are 
CPU sharable, message 04E243D will 
follow. 

Operator Action : If the devices 
are CPU sharable, reply to the 
0aE243D message that follows. If 
the devices are not assigned to the 
background or are system . devices, 
reassign those devices before 
attemipting to re- run control unit 
test. 

E245I OLTEP CANCELED - CANNOT RUN IN 
VIRTUAL MODE 

Cause ; OLTEP was initiated without 
the REAL parameter en the EXEC 
statement. 

System Action ; OLTEP is 
terminated. 

Operator Action ; Initialize CITEP 
in REAL. 

E250I (test -run definition) 



System Action ; Net applicable- 

Operator Action ; Net applicable. 

E251I DUPLICATE ENTRIES IN DEVICE FIELD 

Cause ; The same device address was 
entered more than cnce in the same 
test run definition. 

System Action ; Not applicable. 

Operator Act ion; Re-enter the 
device field correctly. 

E252I SYKBCLIC NAMES AND UNIT ADDRESSES 
KIXED IN DEVICE FIELD 

Cause ; Self explanatory. 

S ystem Action ; Not applicable. 

Op erator Acti on; Re-enter the 
device field with all unit 
addresses or all symbolic names. 

E253I OLT MODULE XXXXXXXX NOT FOUND IN 
LIBRARY 

Cause ; A module requested by the 
active test section was not found 
in the core image library. 

System Action ; The Test Section 
is notified and will determine 
whether it can continue without 
the requested module. 

Operator Action ; If test section 
cannot successfully execute without 
the missing module then first check 
setup or execute DSERV to ensure 
that private libraries were assign- 
ed if necessary. If module is not 
in any library then link edit it 
into the appropriate core image 
library. 

E265I OLTEP CANCELED - RUNS ONLY IN BG 
PARTITION 

Cause; OLTEP was executed in a 
foreground partition. 

Sy ste m Action; OLTEP is 
terminated. 

Operator Action; Re-start OLTEP in 
the background partition. 






Cause : This message contains the 
test-run definition if it was 
entered via the input job stream. 
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E306I IKPUT EEV MUST EE A lAPE 

Cause : Eevice entered in response 
tc message 04E324D was not a tape 
device. 

Systeir i^ ction: Message 04E32^d is 
reissued. 

Operator Actici]: Respond to 
iressage 04E324E with the address of 
a tape unit where the LOGSCAN tape 
is mounted. 

E313I TEST CANCELED^ ATTEMPTED TC WRITE 
Cl^ A FILE PROTECTEE EEVICE 

Cause: The data integrity option 
FPM was in effect, and the unit 
test attempted tc issue a write. 

This is probably a user error. 

Systeir Action: Testing proceeds 
with any repairing test sections. 

Cperator Action : Not applicable. 



04E323D SHOULD RECORDER FILE BE USED, REPLY 
YES OR NO 

Causes This message requests the 
availability of the active recorder 
file. 

System Action : Not applicable. 

Operator Action : Reply R04,'YES* 
if the active recorder file should 
be accessed. Reply R04,'NO' if the 
file should not be used. A NO 
response will result in message 
0aE324D to follow. 

04E32aD MOUNT LOGSCAN TAPE, REPLY DEV ADDR 
OR NO TO BYPASS 

Cause: This message alerts you to 
mount the LOGSCAN tape. 

System Action : Not applicable. 

Operator Action : Mount the LOGSCAN 
tape and enter the device address. 
If the tape is not available or 
there is no tape drive available , 
enter R 04, 'NO'. 

E327I EXT=text 

Cause: This message contains from 
1 to 56 characters of information 
that were entered by the operator 
in the options field (via EXT=text) 
at a DEV/TST/OPT/ communications 
interval. 



System Action : Not applicable. 

Operator Action : Not applicable. 

04E394E ENTER DEV EQUATES/END/CLR 

Cause : EQU was entered in response 
to m.essage 01E105D. This facility 
allows the operator to equate an 
existing CDS for a device which has 
no CES. 

System Action : Not applicable. 

Operator Action : Enter the desired 
equates in any of the following 
formats : 

XXX=ZZZ 

XXX,YYY=ZZZ 

XXX-YYY=ZZZ 

Where XXX and YYY are the devices 
to be tested, and ZZZ is the device 
address for the CDS tc be used in 
testing. Multiple entries can be 
made and must be separated by a 
slash. An entry of 'CLR" will drop 
all existing equates. 'ENE' must 
be entered when all entries have 
been made. 'CLR* and "ENE' may be 
entered on the same line as the 
equates but must be separated by a 
slash . 

Example: 

R 01/CLR/280''180/192-195=290/END' 

E395I ACTIVE EQUATES 

Cause: ENE was entered in response 
tc message 04E394D. 

System Action : All active equates 
are displayed fcr cperator 
verification. 

Cperator Actior: Verify equates. 

04E396D ARE EQUATES CORRECT? YES/NO 

Cause: This message fellows 
message E395I. It is used to 
verify the accuracy of the equates 
that were entered at equate time. 

System Action: A YES response will 
be fcllcwed by message 01E105E. A 
KC response will be followed by 
message 04E394E tc allcw the 
cperator to correct the errors in 
the equates. 

O perator Actic n: If the equates 
are correct as contained in the 
message E395I, then reply YES. If 
corrections or additions are 
required, reply NO. 



/f 
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E397I IKVALIE ENTRY XXXXXX 

Cause I One of the fcllowing errors 
was found in response to iressage 
04E394E: 

1. Slashes entered with no entry 
between their. 

2 . Unit address entry is not 3 or 
4 digits. 

3. Mssing deliiriter. 

4. Inclusive range entered which 
is greater than 16. 

5. Mxed syntax in the saire field 

(i.e., 180,182-186=290) 

The XXXXXX field contains tte 
error. 

Systeir j^ction; Kessage 4E39 4D 
follows. 

Operator j^cticn; Eeteririne the 
error and reply correctly to the 
subsequent 04E39UE iressage. 



B*#^ 



^ 
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E398I EQUi^TEE DEVICES EXCEED 16 

Cause: A device equate was 
attempted when there were already 
16 active equates. 

System Action : Message E395I is 
issued for verification of the 
active equates, followed by message 

04E396D. 

Operator Action : If the equates 
are acceptable as shown in message 
04E395D^ respond YES. If you 
desire to enter more equates, 
respond NO, then enter the correct 
equates or CLE tc change the 
entries - 



E399I EQUATED DEV ADDRESS AND $CtJTEST ARE 
MUTUALLY EXCLUSIVE 

Cause : The test secticn requested 
the $CUTEST function and there are 
equates active. 

System Action : The test section is 
denied the request fcr $CUTEST. 

Operator Action : Clear the active 
equates by invoking a communication 
interval and responding 'CIR ' to 
message 04E394D. Then rerian the 
test section. 

E400I TP LINE CONNECTION, LINE = XXXX 
TERMINAL = XXXXXXXX 

Cause ; This is a header message 
which precedes messages involving 
line connection information. This 
header would only be printed once 
for any group of messages for the 
same device for each line 
connection attempted. Line niamter 
is defined by XXXX. Terminal 
identification is defined by 
XXXXXXXX, which is the terminal 
symbolic name. If XXXX is replaced 
by N/A, the information was not 
available at the time the message 
was issued. 

System Action : Not applicable. 

Programmer Action : Not applicable. 

Operator Action : Net applicable. 

E401I REQUIRED DATA NOT FOUND IN CDS FCR 
XXXXXXXX 

Cause: The device en which a line 
connection was requested does not 
have the required CDS information. 
Position XXXXXXXX will define 
either SETMODE or DAIL, depending 



^ 






on which was f cund missing in the 
CDS entry. 



System Action : Indicate to OLT 
that line connecticn was net 
performed. 

Pr cxrrammer Act^ ien: Net applicable. 

O pera tor Acti cn; Request CCS 
update to be performed by CE. 

E4 02I SYKECIIC NAME FIELD NOT PRESENT IN 
CDS 

Cause: Line ccnnecticn has been 
requested for device net having a 
symbclic namie in the CES entry. 

S ystem Acti cn: Line connecticn is 
net attempted and a return cede is 
returned tc the OLT. 

C peratcr Acti cn: Enter the correct 
device by syirbelic name at the 
communication interval and rerun 
the test or correct the CES. 

E403I INVAIIE LINE CCNN COMMANE SEQUENCE 
IK CES 

Cause: An unassigned Line 
Connecticn comnand sequence cede 
has been detected in the device CDS 
entry. 

System Act ion : Line Connecticn is 
net attempted. A return code is 
returned tc the OLT. 

C peratc r Respcr.se: Request CES 
update to be performed by CE. 

E4 04I DIAL EIGIT COUNT EXCEEES 20 

Cause: The count cf the digits to 
be dialed giver in the device CDS 
entry is greater than 20. 

System Acticpn: Line Connect ion is 
not attempted. A return cede is 
returned tc the CLT indicating that 
line connection was net successful. 

Operator Response; Request CES 
update to be performed by CE. 

E405I CPERATCR CALL REQUIREE, TELEPEONE 
NUMBER NOT PRCVIEEE IN CES 

Cause: The required line is a 
switohed line but dees not have the 
auto call feature either present or 
defined in the CES entry. The line 
may or may not have the auto answer 
feature . 
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System Action ; OLTEP will wait six 
minutes to allow dialing. 



S ysteir J^.ction : Provide a return 
cede indicating that line 
connection was not ccirpleted, 



Operator Action : Manually dial the 
appropriate telephone ntmiber of the 
syirJDclic name device in header 
ir.essage or have the remote terminal 
operator call in. If the 
appropriate telephone number cannot 
be determined^ either you must wait 
a minimum of six minutes for CITEP 
to continue or ycu can cancel the 
background partition. 

E406I OPERATOR CALL TERMINAL ON NUMBER 
XYZ 

Cause : You are required to make an 
intervention to complete the line 
connection of a teleprocessing 
device. 

System Action : System will wait 
I six minutes, allowing ycu to make 
the telephone call- 

Operator Action ; Ycu must manually 
dail the terminal using the 
telephone number XYZ. XYZ may be a 
telephone number of up to 2 
digits. If your response does not 
occur in the allcwed time, the 
E407I message will be issued. 

Note: labile not provided, the 
remote terminal operator could call 
in using the telephone number of 
the line being enabled. (The 
onsite operator must provide the 
telephone number to the remote 
terminal operator.) 

E407I OPERATOR CALL NOT COMPLETED WITHIN 
TIME LIMITS 

Cause: A manual telephone call was 
required by an operator. The call 
may be completed either as outgoing 
or incoming. The call was not 
completed within the allotted time. 

System Action : Provide a return 
code indicating that Line 
Connection was not performed. 

Operator Action : Rerun the test 
and aqcomplish the phone call in 
the allotted time. 

E408I SIO RETURNED A CC=3, NOT 
OPERATIONAL 

Cause: V^hen attempting a line 
connection to a teleprocessing line 
an £10 was issued and found that 
the line was not operational. 



Operator Actio n: Correct the 
non-operational problem to the 
teleprocessing line or eliminate 
the device as a device entry. 

E4 09I SIC FINAL STATUS ERRCR 

CS^=XXXXXXXXXXXXXX , SNS=YY 

Cause: An errcr (unit check) has 
occurred in the sequence of CCVi's 
necessary for line connection. The 
ending channel status word is given 
in XXXXXXXXXXXXXX. I^. sense command 
is issued after the error and the 
sense information is given in YY. 

System i^ction: Provide return code 
indicating that a line connection 
was not perforired. 

Opera tor Action : Not applicable. 

E410I FIKAL STATUS NOT RECEIVED FROM I/O 
OPERATION 

Cause : In an attempt to perform, a 
channel program to provide line 
connection, a no final status 
connection occurred. 

System j^ction: Provide a return 
code indicating that a line 
connection was not performed. 

Operator j^cticr : Not applicable. 

E412I CCW CHAIN TERMINATED ON 
XXXXXXXXXXXXXXXX 

Cause: An errcr (unit check) has 
occurred in the sequence of CCVv's 
ijecessary fc£ liije cciujectiun. 
This message will print the failing 
CCW in hex digits XXXXXXXXXXXXXXXX - 

System Actio n: Provide a return 
code indicating that line 
connection was rot performed. If 
final status has not been received, 
an HIC to clear the line will be 
issued. 

Operator Action: Not applicable. 

E413I RECUIREE CDS POINTER NOT PRESENI 

Cause: Any request for an 
operation to a teleprocessing 
terminal must provide a pointer to 
the CDS information for that 
device. In this case the pointer 
was zero which is an invalid case 
caused by program error in the OLT. 



( 
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System Action ; I/O operation or 
Line Connection is net attempted 
and a return code is returned to 
the caller. 



Operator Action ; Inform CE. 

E414I ALL 1EST TP LINES WILL BE DISABLED 

Cause; Operator is notified that 
OLTEP is disabling all IP lines 
that were previously enabled, 

System Action ; OLTEP issues a 
DISABLE command to any IP line 
previously enabled. 

Programmer Action ; Net applicable. 

Operator Action ; Not applicable. 

EaSOI [*] RIN UUU, ID W^AT IwWK^^'K 

[,RC XX] 

Cause ; The TR option is on or the 
OLT is using return cede handling 
and return code was unacceptable. 
The fields are as follows; 

1. UUX] - routine nijmber. 



2. W - function identification, 

(last two characters of the 
phase name of the OLTEP module 
called by the OLT.) 

3 . WWWWKW - contents of register 
14 at time of call, 

4. XX ~ return value given. 

RC is not displayed if the function 
does not have a return code. The 
asterisk is added if this return 
code caused the OLT to terminate. 

S ystem Actio n; Net applicable. 

Op erator Actio n; Refer to OLT 
write-up for the reason for 
termination if asterisk is present, 

E501I T2400W BYPASSED, INVALID TEST 



Cause ; T2400W was entered in the 
test field. This test section is 



no longer supported. 



System Action; 
bypassed. 



The test section is 



Operato r Action; Net applicable. 
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Glossary 



•^ 

1 1 



For a more complete list of data processing 
terms, refer to the IBM Data Processing 
Techniques, A Data Processing Glossary , 
GC24-1699. 



i^SCII (j^ir.erican National Standard Code for 
Information Interchange) ; A 128-character , 
7-bit code. The high- order bit in the 
System/ 3 60 8-bit environment is zero. 

CE cell ; A data cell used to test an IBK 
2321. A CE cell is reccgnized by a sense 
to bin 0, subcell 19. If the CE sense tit 
is on, the CE cell is mounted. 

CE pack ; A disk pack used to test an IBM 
DASD other than the 2321. A CE pack is any 
of the following; 

1. A pack with a V0L1 label of CEPACK, 

2. A 3330 with the CE bit on, or 

3. A 2314/2311 with FOFE on cylinder 6, 
track 0, record 0. 

CE_volume: If the device is a 2321, see CE 
cell ; otherwise see CE pack . 



CLEANUP: 



A routine that exists within an 



OLT and is designated tc bring the test 
devices back to pre -test status when the 
OLT is abnormally terminated. 

communications interval : A period of 
communication between the c en sole operator 
and OLTEP. The operator is requested by 
OLTEP to enter the test-run definition at 
this timie. 



permission from the operator until this 
date has expired. 

File P rotect Mode (FPM ) ; A mcde of 
operation that insures iraxiirum, protection 
and security of customer data, ^hile in 
file protect mcde, the CLT is not allowed 
to perform write operations. 



Cn-Iine Test (CLT): 



A test program of the 
The tests reside in 



online test system 
the core image library, and are brought 
into core storage by OLTEP when requested 
by the operator. 

Cn-Iin e Te st Executiv e Program (OLTEP) : 

The control program of the online test 
system.. CITEP is the interface between the 
online test and the operating system. 

onlin e te st system: A control prog ran, 
CITEP, and a series of tests (CLTs) 
designed to test I/O devices while 
permitting normal system processing in the 
foreground partitions. 

privil eged ins truction; An instruction 
that can be executed only while the CPU is 
in the supervisor state- Protection, I/O, 
direct control, and any instructions that 
manipulate the program status words are 
privileged. 

prom pting; A request for help made by the 
operator when entering the test-run 
definition. OLTEP prints examples of the 
field requested by the operator. 



M 
ligr 



Configuration Data Set (CDS) : A record of 
information about an I/O device or CPU 
accessed by OLTEP and the OLT. 

data protection ; A safeguard invoked to 
prevent the destruction of customer data. 

da ta s ecur i t y : A safeguard invoked to 
prevent the accessing of volume security 
protected customer data. 

default value : A predetermined value used 
in place of an omitted entry. 

equate : A facility which allows the use of 
existing CCSs for devices which have the 
same configuration but different device 
addresses. 

expiration date ; A date within a tape 
label for data protection. the tape cannot 
be used as a scratch tape without 



Cuie s ce Kcde : A mode of operation that 
requires the foreground partition to be 
stopped by the operator. The operator does 
this on the console by issuing the PAUSE 
EOJ and STCP commands when requested by 
OLTEP. 

remote terminal; A re note terminal is one 
usually separated from the CPU (into which 
CITEP is loaded) by a distance that is 
sufficient to require common carrier 
facilities for inter-communication. A 
station is considered remote if it is 
connected to the CPU through a Transmission 
Control Unit (TCU). 



Stand Alone Online Test Sup port ( S OSP 
program; A utility program executed as 
though it were an OLT. SOSP facilities the 
creation and maintenance of configuration 
data set and online test sections by the 
CE. 
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supervisor state : The state cf CPO test-run definition ; Infcriration requested _ 

operation that allows execution of by CLTEP at the various ccxritunications /^ 

privileged instructions. When bit 15 of intervals. This inforiraticn consists of ^ 

the PSW is zero^ the CPU is in the the device tc be tested, the test or test 

supervisor state. routines tc be executed, and the opticns to 

be exercised. 
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Genera! Index by Module 



V 



Indexes to system reference library manuals 
are consolidated in the DOS Master Index ^ 
GC24-5063. For additional information 
about any subject listed in the modular 
outlines or the modular indexes, refer to 
other publications listed for the same 
subject in the Master Index. 



accessing of error recording data 11 
ASCII mode 10 

background partition 9 

calling OLTEP 16 

card input 16 

CDS equate 22 

CE volume 11 

changing the test procedure 15 

choosing the devices 17 

choosing the options 20 

choosing the test 18 

communications interval 9,15 

console interrupt 10 

DASD 11 

data integrity 10,11 

data protection 10,14 

data protection measures 10 

data security 14 

device address field 18 

device equates 22 

device preparation 14 

device selection 17 

diagnostic tape 14 

environmental recording data set 11 
example of OLTEP operation 2 0,21 
example of RETAIN/370 operation 28,29 
expiration date 10 

features of OLTEP 8 

file protect mode 11 

first error communications interval 10,15 

FOPT macro parameter 14 

FOPT RETAIN parameter 2 7 

functions of OLTEP 8 

generating an OLT library 14 
glossary 49-50 

help 22 
history tape 11 

initial communications interval 10,15 

initialization 28 

interrupt communications interval 10,15 

interrupt key 10,15 

interval timer 14 

job control statements 14,16,2 8 






line connection routine 23 

machine configuration 26 
macro parameters 14 
main storage requirements 2 7 
message handling 2 8 
messages 31-47 
multiprogramming systems 8 

non-file protect mode 11 

OLT 9 

OLT library 14 

OLTEP function 8 

OLTEP messages 9 

OLTEP operation 2 

OLTEP requirements 14 

OLTEP structure 9 

OLTSEP 14 

online tests 9 

operating procedures 15,16 

operator communications 9 

option field 20 

parameters 14 
partition sizes 9 
preparation 14 
prompting 22 
PROMPT XXX 22 

quiesce mode 23 

REI 2 8 

reply format 17,28,29 

requirements for OLTEP operation 14 

resident area 9 

RETAIN/370 2 6,28 

running the tests 16 

security byte 10 

size requirements 9,2 7 

software requirements 2 7 

SOSP 14 

space allocation 11 

special operating considerations 23 

standard label 10 

STOPREI 2 9 

storage allocation 27 

system error recovery procedures 11 

system generation 27 

system operation 

with card input 16 

with console input 15 

with no console input 16 

teleprocessing lines 23 
teleprocessing requirements 26 
terminating RETAIN/370 2 8 
test-run definition 9,15 
test-run definition card 15 
test completion communications interval 
10,15 
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test field 18 

test routine 18 

test section 18 

test type 18 

timer and TOD clock 14 

transient area 9 

transient module 9 

user language 9 

volume reformatting 11 
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will be sent to the author's department for appropriate action. Using this 
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This Technical Newsletter, a part of release 29 of the IBM Disk Operating System, provides 
replacement pages for the subject publication. These replacement pages remain in effect 
for subsequent releases unless specifically altered. Pages to be inserted and/or removed are: 

Cover, Edition Notice 

11, 12 

43,44,44.1 

45,46 

49,50 

A change to the text or to an illustration is indicated by a vertical line to the left of the 
change. 



■\ 



Summary of Amendments 

• addition of new message (page 44). 

• expanded definition of CEPACK (page 50). 

• minor editorial changes. 

Note: Please file this cover letter at the back of the manual to provide a record of 
changes. 
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